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Getting Started 


Before physically installing a disk drive, tape drive, printer, or other 
peripheral device, you must configurethe H P-UX operating system to 
communicate with it. Configuring H P-UX for Peripherals provides the 
software information needed for system administrators to configure the 
many peripheral devices supported on H P-UX. 

Read this chapter for: 

• an overview of peripheral configuration 

• explanation of I/O convergence 

• explanation of loadable drivers 

• syntax of device special file names 

• information on associating device special files with their peripheral 
devices, by using issf and ioscan 

Keep this document and the following other documents available for 
reference when installing and configuring peripheral devices: 

• installation manuals shipped with the device 

• HP-UX Managing Systems and Workgroups 

• HP-UX Reference 

Commands such asmksf, insf, and ioscan (now available on both 
Series 700 and 800 systems) make it largely unnecessary to manipulate 
the minor number literally. However, if you are configuring a peripheral 
for unusual circumstances, you should consult the appendices at the end 
of this document. 


Configuring a peripheral device requires that you operate with root 
privi leges. I n consideration for others on the system, exercise caution 
when acting as superuser. 


HP I nterface Bus (HP-1 B) and HP Fiber Link (HP-FL) disks and 
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interface cards are not supported by H P-UX Release 11.0. All such 
devices should be removed from your system before installing or 
updating to H P-UX Release 11.0. 
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Peripheral Configuration in its Simplest 
Terms 

You must perform the following three steps before a peripheral device 
can communicate with an HP-UX system: 

Step 1. Configure the device driver(s) into the kernel. Device drivers are 
I ike translators that speak both the language of the peripheral device 
and the language of the computer. 

Step 2. Install the hardware. Perform any hardware-specific installation 

procedures required to physically connect the peripheral device to your 
computer. Then, turn on the power to the peripheral devices and then to 
the computer. 

Step 3. Reboot the system. As the system reboots, H P-U X automatical ly 

creates the necessary device special files required for the peripheral. At 
least one device special file must exist for a device driver to communicate 
with the peripheral device. Device special files tell the operating system 
which device driver to use, how to find the peripheral device, and what 
special characteristics the peripheral device employs. 


Figure 1-1 


The Essentials of Peripheral Configuration 
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NOTE Often, if you anticipate having to add a new external peripheral device, 

you can configure the device drivers into the kernel at a time when no 
one else is on the system. Then, when the peripheral arrives, you can 
physically install it with minimal user disruption. 


Using SAM to Configure Peripherals 

The H P-UX System Administration Manager (SAM) provides the easiest 
way to: 

• view your system's configuration 

• configure the peripheral device's drivers intothe kernel 

• regenerate the kernel after configuri ng the software 
To i nvoke SAM, type /usr/sbin/sam. 

SAM's user interface and online help system allow you to discover the 
configuration information as you proceed through its screens. Once you 
provide SAM with basic information about the device being configured, 
SAM performs the following tasks: 

• checks your currently running kernel configuration file for the 
required device drivers 

• reports whether or not the drivers are present 

• adds the drivers if necessary 

• reconfigures the kernel 

For some devices, SAM also automates other necessary steps. For 
example, when adding a terminal to your system, SAM edits the 
/etc/inittab fileto add the terminal entry. You have to perform this 
step manually if you are not using SAM to configure the terminal. 

Using HP-UX Commands to Configure Peripherals 

You must use FI P-UX commands to configure peripherals into the system 
if the device cannot be automatically configured or if SAM isnoton your 
system. 

Virtually all Flewlett-Packard disk drives, tape drives, printers, plotters 
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and terminals are configurable automatically. Each peripheral-specific 
chapter of this document gives procedures for using H P-UX commands 
for configuration. 

Exceptions: Drivers insf Cannot Recognize 

Third-party drivers and certain drivers used for instrumentation or 
black-box applications are not recognized by insf, so insf cannot 
automatically create device files during the reboot process. 

If you are adding a peripheral device requiring a driver that cannot be 
configured automatically you must configure the device driver and 
create the device files using the ioscan and mksf or mknod commands. 

For guidance in these cases, consult Appendix C , "Major and Minor 
Numbers," at the end of this document. Chapter 7 , "Configuring 
Printers and Plotters," also has information on configuring instruments 
that require manual manipulation. 
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Understanding I/O Convergence 

As of HP-UX Release 10.0, the HP-UX I/O system is largely converged, 
allowing for an environment that supports a greater flexibility of bus 
architectural combinations. The convergence is seen most dramatically 
on Model K (8x9) systems, which have capabilities previously found only 
on Series 700 workstations. 

From an administrative perspective, I/O convergence means that the 
vast majority of configuration tasks are now performed identically, 
whether for a Series 700 or Series 800 system. Device file names on both 
architectures are consistent (the naming convention is explained in 
"Understanding Device Special FileNames"on page 21), and drivers 
have been streamlined to work in this converged environment. 

Think of the drivers as belonging to one of two broad categories, 
according to the PA-RI SC bus architecture on which they run — the 
Server I/O (SI 0) system and the Workstation I/O (WSI0) system. The 
SIO driver environment includes Series 800 CIO and HP-PB bus 
architectures. The WSI 0 driver environment supports bus architectures 
traditionally associated with Series 700 workstations, and provides 
greater openness for use of third-party interfaces and devices. 

Throughout this document, the terms Series 700 and 800 continue to be 
used, as the command uname -m continues to report Series 700 or 800 
model numbers. Although we use the terms Series 700 and Series 800 
when we describe drivers, we are really implying WSIO or SIO driver 
environments. These separate environments permit only those drivers 
required by a given bus architecture to be configured into the kernel as 
needed (for example, only WSI 0 drivers on a legacy Series 700 system or 
SI 0 and WSI 0 drivers on a Series 800 system). 

Read the /usr/conf/master .d/core-hpux file to better understand the 
architectural context dependencies. Also, consult master (4) in the 
HP-UX Reference 
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NOTE 


Understanding Loadable Device Drivers 

As of HP-UX Release 11.0, a new feature known as Dynamically 
Loadable Kernel Module (DLKM) provides the means to add a device 
driver to a running UNIX system without rebooting the system or 
rebuilding the kernel. This feature also makes it possible to dynamically 
remove a device driver from the UNIX system when the driver is no 
longer needed, thereby freeing system resources for other use. 

The DLKM feature not only provides the infrastructure to load drivers 
into a running kernel, but it also allows a driver to be statically linked 
into the kernel—the way all drivers were included in the kernel prior to 
HP-UX 11.0. Simply setting a flag in one of the driver's configuration 
files determines whether a driver is to be configured as dynamically 
loadable or statically linked. 

For H P-UX 11.0, the system must be in a run-time state before dynamic 
module loading is available. Thus, drivers required during system boot 
must be configured as statically linked. 

DLKM ModuleTypes 

The DLKM feature currently supports the fol lowing types of drivers: 
WSIO class drivers, WSIO interface drivers, and STREAMS drivers. It 
also supports STREAMS modules and miscellaneous modules. An 
example of a miscellaneous module is a module containing support 
functions not required in the statically configured kernel but shared 
among multiple loadable modules. 

New Module Packaging 

As of HP-UX 11.0, each driver may have its own master and system 
files, whereas prior to H P-UX 11.0, the driver shared master files and 
had access to a single system file—the HP-UX system file 
(/stand/system by default). (TheHP-UX system file is sti II supported in 
HP-UX 11.0.) This new way of packaging drivers together with the new 
way of writing driver source code is what makes the DLKM feature 
possi ble. 


Seethe master (4) manpagefor descriptions of the two kinds of master 
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files, and theconfig (IM) manpagefor a description of the H P-UX system 
file. 


Advantages of DLKM Drivers 

DLKM drivers/modules provide many advantages relative to static 

drivers/modules, including: 

• making it easier for administrators to install device drivers from 
other vendors 

• improving system availability by allowing device drivers and other 
modules to be configured into the kernel while the system is running 

• conserving system resources by unloading infrequently used modules 
when not in use 

• providing administrators with the ability to demand load and unload 
modules 

• providing the kernel with the ability to automatically load modules 

Auto loading occurs when the kernel detects a particular loadable 

module is required to accomplish some task, but the module is not 

currently loaded. The kernel automatically loads the module. 


NOTE Auto unloading is not supported in H P-UX 11.0. 
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Understanding Device Special File Names 

Device special files tell the operati ng system which device driver to use, 
how to find the peripheral device, and what characteristics the 
peripheral device should employ. Characteristics vary by device. Thus, 
device special files for magneto-optical devices show the surface being 
addressed, while those for tape drives show rewind and density. 

Most device special file names contain the location of the device on the 
bus architecture. To see this, display the files in any subdirectory of the 
/dev directory. Note, all mass storage devices adhere to a syntax that 
includes c#t#d# [s#] (other kindsof device files use a related 
convention): 

c# represents the card instance number for the class of 

intafacecard to which the device is connected. Classes 
of i nterface cards i ncl ude ext_bus, graphics, tty, lan, 
and others. The card instance of an interface card is 
unique for its specific class. There is no relationship 
between the instance number and the slot number of 
the interface card in the card cage. 

Class and instance number can be seen in the first two 
columns of /usr/sbin/ioscan -f OUtput. When 
interpreting a device special file, the only significant 
instance number is the card instance (that is, the 
instance number for the class of interface to which a 
device is attached). Thus, in a sample disk device file 
/dev/rdsk/cit4d0, the cl refers to the card instance, 
not to an LU number (as in previous releases). 

t# represents the target address of the device on the 

interface bus. The address can range from o to 7 for a 
single-ended device, and from o to is for a fast wide 
device. Typically t# is the address set with jumpers or 
dip switches on the device itself. 

d# represents the device number, and can range from o 

to 7 maximum. On SCSI devices, d# is the SCSI LUN. 
Except for multi-function devices, d# is typically dO. 

s# specifies section number (optional; made avail able for 

backward compatibility). Note, section o now 
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represents the entire disk, whiie section 2 represents a 
smaii disk section (previousiy section o). if the s# is not 
shown, the device speciai fiierefers tothe entiredisk. 

Sample Device Special File Names 

Every peripherai-specific chapter in this document has tabiesof 
configuration requirements that show the defauit device speciai fiie 
names for that ciass of device. Here are some sampie device speciai fiies 
and their possibie meanings: 


/dev/rdsk/cOt 6d0 

Entiredisk accessed in character 
(raw) mode through SCSi card 
instance 0, target 6, LUN 0. 

/dev/rac/cOtOdO_lla 

Surface 11a of a magneto-opticai disk 
whose autochanger in a disk iibrary 
accessed in raw mode through card 
instance0, target 0, LUN 0. 

/dev/rmt/cltOdOBESTnb 

Tape drive accessed through card 
instance 1, target 0, LUN 0. Tape 
writes at best avaiiabie 
density/format, no rewind, 

B er kei ey-sty i e ci ose. 

/dev/rmt/Omnb 

Tape drive device speciai fiie with 
identicai characteristics (iinked) to 

/dev/rmt/cltOdOBESTnb. 

/dev/fIoppy/clt3d0 

Entirefloppy disk drive accessed in 
biock mode through SCSi card 
instance 1 iocated in siot 13, with 
targets, LUN 0. 

/dev/ttyOpO 

Seriai port of buiit-in card instance 0 
port 0, hardwired at address 56.0; 
accessed through driver mux4. 

/dev/cltOdO_lp 

Paraiiei port on core i/0 card 1, set to 
handshake mode 2. 

/dev/lp 

Paraiiei port on core i/0 card 1, set to 
handshake mode 2; device fiie is 


iinked to /dev/citOdO_ip. 

Both issf and ioscan commands dispi ay the interface to which adevice 
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is connected. These are discussed in the next sections. 

Decoding Device Special Files with Issf 

Use the /usr/sbin/issf Command to decode device speciai fiies. The 
foiiowing figure compares ii and issf output. 


NOTE Throughout this document, exampies of commands usage are shown as 

command text. 


11 /dev/rac/cltld0_2a 

crw-rr 1 root users 230 0x011003 May 3 16:46 /dev/rac/cltld0_2a 

/usr/sbin/lssf /dev/rac/cltld0_2a 

autoxO card instance 1 SCSI target 1 SCSI LUN 0 optical disk 2 side a 
at address 52.1.0 /dev/rac/cltId0_2a214 

11 /dev/rmt/cOtldONOMOD 

crw-rwrw 1 bin bin 205 OxOOlOOf May 4 11:31 /dev/rrat/cOtldONOMOD 

/usr/sbin/lssf /dev/rmt/cOtldONOMOD 

stape card instance 0 SCSI target 1 SCSI LUN 0 at&t keep existing density/format 
at address 2/0/1.1.0 /dev/rmt/cOtldONOMOD 

11 /dev/rmt/cOtldOBESTb 

crw-rwrw 2 bin bin 205 0x001080 Apr 28 17:24 /dev/rmt/cOtldOBESTb 

/usr/sbin/lssf /dev/rmt/cOtldOBESTb 

stape card instance 0 SCSI target 1 SCSI LUN 0 berkeley best density available 
at address 2/0/1.1.0 /dev/rmt/cOtldOBESTb 
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Viewing the System Configuration with ioscan 

The /usr/sbin/ioscan command is the single most versatile tool in 
HP-UX for displaying your system configuration. For example, you can 
use ioscan to identify available hardware addresses. 

Terse Listing of ioscan 

In its simplest form, /usr/sbin/ioscan displays hardware path, device 
class, and description. The -u (usabledevice) or -k (kernel structure) 
option gives fastest response, because neither option probes the 
hardware. 

The following example shows devices on a Series 800 Model E, connected 
through the H P-PB bus converter at address 56. The 56/52 is the 
address of the single-ended SCSI interface. The shaded digits below are 
the addresses already being used on the card. Note that there is no 
56/52.4.0. If you attach another SCSI device to this card, you can set its 
address to 4. 

/usr/sbin/ioscan -k 


H/w Path 

Class 

Description 



56 

be 

Bus Converter 


56/52 

ext_bus 

HP 28655A - 

SCSI 

Inter 

56/52.0 

target 




56/52.0.0 

tape 

SCSI Tape 



56/52.1 

target 




56/52.1.0 

disk 

HP C2247M1 - 

SCSI 

Disk 

56/52.2 

target 




56/52.2.0 

disk 

HP C2247M1 - 

SCSI 

Disk 

56/52.3 

target 




56/52.3.0 

disk 

TEAC FC-1 .. 

. - SCSI D 

56/52.5 

target 




56/52.5.0 

disk 

HP C2247M1 - 

SCSI 

Disk 

56/52.6 

target 




56/52.6.0 

disk 

HP C2247M1 - 

SCSI 

Disk 


Understanding Hardware Addresses 

You can identify each piece of hardware configured to an HP-UX 
computer by its hardware address (shown in ioscan as h/w Path). 
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The length of these numerical sequences differ by system model and 
architecture, but every hardware path leads you through the bus 
structure, starting from the bus closest to the system processor and 
ending at the output device. 

ioscan -H hardware_path shows you the Sequence of connection to or 
from the specified location. In the following example, which displays 
output from a Model 770, a disk attached to the GSC built-in Fast/Wide 
SCSI I nterface has the hardware address 8/0.5. o. 

/usr/sbin/ioscan -H 8/0.5.0 

H/W Path Class Description 


8 

8/0 
8/0.5 
8/0.5.0 

The hardware path can be decoded as follows: 

8 identifies the bus adapter connecting the GSC-Fbus to 

the system bus. 

0 identifies the slot number of the Fast/Wide SCSI 

interface. (See Figure B-3 in Appendix B, Bus 
Architectures.) 

5 represents the "target," or SCSI address, set on the 

disk device itself. 

0 indicates a unit number or SCSI LUN number. 

Field separators slash (/) and dot (.) separate the numbers of the 
hardware address and have no bearing on system administration. The 
displayed classes are more meaningful in the context of instance 
numbers, which are visible in ioscan -f listings, and will be discussed 
shortly. Explanation of hardware addresses on multi-function cards is in 
Appendix B , "Bus Architectures." 

Understanding the Description in ioscan 

The description field displayed by ioscan derives from the peripheral 
device itself. Typically, a numeric description refers to the 
manufacturer's vendor ID, and in some cases, this number corresponds 
to more than one model number. If you are troubleshooting a peripheral's 
problem, the description is often useful information to an FI P support 


be 

be I/O Adapter 

ext_bus GSC built-in Fast/Wide SCSI Interfaee 

target 

disk DEC DSP3210SW 
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engineer. 

Full Listing of ioscan 

ioscan -f displays full information about the system configuration, 
including instance number, device/interface driver, software state, and 
hardware type. The -fn option also displays the device special files. 

/usr/sbin/ioscan -f 


Class 

I 

H/W Path 

Driver 

S/W State 

H/W Type 

Description 

ext_bus 

0 

8/0 

c720 

CLAIMED 

INTERFACE 

F/W SCSI 

target 

0 

8/0.5 

tgt 

CLAIMED 

DEVICE 


disk 

0 

8/0.5.0 

sdisk 

CLAIMED 

DEVICE 

HP C2247 

ba 

0 

8/12 

bus_adapte 

r CLAIMED 

BUS_NEXUS 

Core I/O Adapter 

ext_bus 

2 

8/12/0 

CentIf 

CLAIMED 

INTERFACE 

Parallel Interface 

audio 

0 

8/12/1 

audio 

CLAIMED 

INTERFACE 

Audio 

tty 

0 

8/12/4 

asioO 

CLAIMED 

INTERFACE 

RS-232C 

ext_bus 

1 

8/12/5 

c700 

CLAIMED 

INTERFACE 

SCSI 

target 

1 

8/12/5.0 

tgt 

CLAIMED 

DEVICE 


disk 

1 

8/12/5.0.0 

sf lop 

CLAIMED 

DEVICE 

TEAC FC-1 

Ian 

0 

8/12/6 

lan2 

CLAIMED 

INTERFACE 

LAN 

be 

2 

10 

ccio 

CLAIMED 

BUS_NEXUS 

I/O Adapter 

graphics 

0 

10/0 

graphs 

CLAIMED 

INTERFACE 

Graphics 


Understanding Class and Instance 

The following ioscan output shows just theext_bus class of a sample 
Model 770 system. The card instance numbers are listed under i and are 
highlighted. 

For device file naming and hardware mapping, the only significant 
instance numbers are those associated with the interface hardware 
type. 

/usr/sbin/ioscan -C ext_bus -f 

Class I H/W Path Driver S/W State H/W Type Description 


ext_bus 0 8/0 c720 CLAIMED INTERFACE F/W SCSI 

ext_bus 2 8/12/0 Centif CLAIMED INTERFACE Parallel Interface 

ext_bus 1 8/12/5 c700 CLAIMED INTERFACE SCSI 
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The card instance number isassigned by the operating system to the 
interface card and reflects the order ioconfig binds that class of 
interface card to its driver when it boots. 

I nstance is stored in two files — /etc/ioconfig and /stand/ioconfig. 
Information in these files retain their information across reboots, unless 
one is corrupted or missing, in which case, ioinit will rebuild the entire 
/dev structure. (If this occurs, you would have to recreate any 
customized permissions or files.) 

An Example Showing Correlation Between Card Instance and 
Device Files 

The following example shows ioscan output taken from a Model 735. 
This example shows how card instance number and hardware path 
elements map directly into the device special file /dev/dsk/citSdO as 
card instance, target number, and device number. 

Typically, the card instance maps as the digit after the letter c (or for 
terminals, the number after tty). For this example, the digit is i, as 
shown in the second field of the first entry below. 

Note, the card instance designated in the device special file refers to the 
interface card, not to the instance number of the peripheral device 
attached to the card. (Ignore those numbers. This is a departure from the 
LU concept of previous H P-UX Series 800 releases. LU numbers were 
similar to device instance numbers and are not used.) 

The card instance number is unique only for the specific class (in this 
case, ext_bus) of interface. Thus, for example, the tty class of interface 
has its own sequence of card instance numbers, beginning with zero, 
which appear in its device files. 

/usr/sbin/ioscan -fn -H 2/0/7 


Class 

I 

H/W Path 

Driver 

S/W State 

H/W Type 

Description 

ext_bus 

1 

2/0/7 

c700 

CLAIMED 

INTERFACE 

Built-in F/W SCSI 

target 

3 

2/0/7.5 

target 

CLAIMED 

DEVICE 


disk 

2 

2/0/7.5.0 

sdisk 

CLAIMED 

DEVICE 

HP C2247 


/dev/dsk/cltSdO /dev/rdsk/cltSdO 
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Identifying Device Special Files Associated with a Peripheral 
Device 

You can use ioscan -fn (or -fkn or -fun) to show device special file 
names associated with a peripheral. You can also add other ioscan 
options (such as -h, -c, -d, or -i) to limit your output to specific 
elements in your configuration. 

The following example, using -c tape, shows the device files available 
for tape class, as well as the location and type of tape device. Note too, 
the new tape device file naming convention. These are explained in 
Chapter 6 , "Configuring Tape Drives," and on the mt (7) manpage. 

/usr/sbin/ioscan -fn -C tape 

Class I H/W Path Driver S/W State H/W Type Description 


tape 0 56/52.0.0 tape2 CLAIMED DEVICE WANGTEK 51000 SCSI 

/dev/diag/rmt/cOtOdO /dev/rmt/cOtOdOBESTn 

/dev/rmt/cOtOdOBEST /dev/rmt/cOtOdOBESTnb 
/dev/rmt/cOtOdOBESTb 

Consult the ioscan (IM) manpage for further information about this tool. 
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NOTE 


Configuring HP-UX for any Peripheral (A 
Summary) 

Prepare by gathering information required for the successfui 
configuration of the peripherai. Considerations vary and arediscussed in 
each peripherai-specific chapter. For exampie: 

• H ave you prepared the physicai iocation for the peripherai device? 

• To what interface are you connecting the peripherai? 

• What device drivers are required by the peripherai device? 

i n virtuaiiy aii cases, the System Administration Manager (SAM) 
provides the si mpiest interface for configuring HP-UX for any standard 
peripherai device, if you must use the command iine interface instead of 
SAM, thefoiiowing procedure wiii famiii arize you with the task. 

Step 1. Determine the device drivers needed for your peripherai device and 

interface by consuiting thetabies in the chapter devoted to that dass of 
peripherai device, if any necessary static device driver is absent from the 
kernei, you wiii need to rebuiid the kernei to inciude it. 

Here is how to rebuiid the kernei: 

a. Change directory to the buiid environment (/stand/build). There, 
execute a system preparation script, system_prep. sYstem_prep 
writes a system fiie based on your current kernei in the current 
directory. (That is, it creates /stand/buiid/system.)The-v provides 
verbose expianation as the script executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

b. Modify the/stand/build/system fiieto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


To avoid introducing format errors, do not edit the HP-UX system 
description fiies directiy. instead, use the commands kmsystem and 
kmtune. These commands are new for Reiease 11.0; consuit kmsystem 
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(IM) and kmtune(lM) in the H P-UX Reference 


c. Build the new kernel by invoking the mk_kernei command. This 
creates /stand/buiid/vmunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Preparefor rebootingby invoking the kmupdate command. This sets a 
flag that tells the system to use the new kernel when it restarts. 

/usr/sbin/kmupdate 

Step 2. Notify users that the system must be rebooted. 

Step 3. Shut down and halt the system using the /usr/sbin/shutdown -h 
command. 

a. When HALTED, you may cycle power appears on the Screen, turn off 
the computer and unplug the power cord. This is recommended for all 
devices; for SCSI devices and interface cards, it is required. 

b. Install the peripheral device, following directions in the supplied 
hardware documentation. 

c. Power on the peripheral devices and wait for them to signal ready; 
then power on the computer system, which wi 11 cause your system to 
reboot. As HP-UX reboots, it will create the device special files 
required by the new peripheral device in the appropriate /dev 
directories. 


NOTE Before attempting to reboot using the new kernel, the system startup 

scripts save a copy of the old kernel in / stand/vmunix.prev. If the new 
kernel won't boot, use this copy of the old kernel, together with the copy 
of the old system file you saved in /stand/system.prev, to restart the 
system. 


Step 4. Verify the configuration by invoking the ioscan command, as discussed 
earlier in this chapter. 
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2 Configuring i nterface Cards 


Configuring an interface card or device adapter may provide new 
connectivity to external devices or instruments. For this connectivity to 
occur, the interface driver for the card must be present in the kernel. 
When the system is booted, H P-UX associates the driver (software 
module) with the card (hardware path) to provide communication for the 
external device or instrument. 

Figure 2-1 Roie of Drivers in Configuring interface Cards and Peripheral 

Devices 



This chapter gives guidelines and configuration procedures for each type 
of HP interface card. If you are configuring an El SA or ISA card, also 
consult Appendix A, EISA Board Configuration. If you are configuring a 
custom SI 0-style driver, consult Appendix C, Major and Minor Numbers. 
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Planning to Configure an I nterface Card 

• Read the instructions to be sure you understand them before 
proceeding. Have avail able the documentation supplied with the 
interface card. 

• Observe anti-static precautions when handling interface cards. 

I nterface cards and device adapters are suscepti ble to damage by 
electrostatic discharge, which can result in degraded performance or 
loss of operation. 

— Keep the card in its anti-static packaging until you install it, or 
use a static-free workstation, HP part number 9300-0933. 

— Use a grounding wrist strap when handling the interface card. 

— Handle the card only by its non-connector edges, faceplate 
(bulkhead), or extractor levers. 

— I f necessary, store i nterface cards and device adapters i n thei r 
original shipping containers or equivalent anti-static packaging. 
The storage area should be clean, dry, and free of corrosive 
elements. 

< Create a detailed record of your configuration. 

— Use a worksheet in the back of this document to record the data 
provided on the stickers attached to the card. I f problems arise, 
the codes provide service engineers with manufacturing version. 
The following information typically appears on the stickers: 

— Part number 

— Version and date, encoded in a five-digit alphanumeric string 
— Serial number, encoded in a ten-digit alphanumeric string 
— Other production identification information. 

— Record the firmware revision of the interface card. 

— Record the link level address for the processor. It comes with the 
shipping. The /usr/sbin/ianadmin command reports back the 
station address. 

— Record any dip switches or address settings you make on any 
cards or external devices. 
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NOTE 


— Keep a current copy of output from /usr/sbin/ioscan -f, for a 
total pictureof your system's configuration, including use of 
hardware slots and configured device drivers. 


The HP Precision Bus (HP-PB) backplane is a slot-priority based system. 
The higher the slot number in which a card is installed, the higher the 
card's priority for gaining access to and communicating over the 
backplane. Thus, a card installed at slot 10 has a higher priority than a 
card at slot 1. 


• Observe HP recommendations regarding hardware 
limitations and requirements. 

— Do not exceed recommended cabling lengths or maximum number 
of peripheral devices connected to an interface card. Note, these 
limitations vary widely depending on bus traffic, kind of I/O, and 
system. For explicit information, consult "Maximum 
Configurations"or other HP-published configuration guidelines. 

— Take care that total power consumption of all voltages does not 
exceed card-cage limitations. 

— Terminate SCSI devices as required. (See "SCSI Signal 
Termination", later in this chapter, for explanation of SCSI 
terminators.) 

< If desired, install application software before physically 
installing the card. Use the /usr/sbin/swinstaii command and 
then reboot the system. 

• V\fern users in advance that you plan to bring the system down for 
installation. On a multiuser system, you can use the wall (IM) 
command. 

• Do not connect or disconnect a device while the system is 
running. Do not turn power on or off to a mass storage device 
connected to a powered-up system. Doing so could result in data 
corruption or a system panic. 

Maximum Configurations 

Depending on interface, multiple peripheral devicescan be connected to 

any interface card. However, because maximum device connections are 
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device- and platform-dependent, the following information represents 
basic guidelines only. For detailed information, contact an HP Customer 
Engineer or field office, which should have access to recent information 
published in the HP 9000 configuration and price guides. 


Maximum Recommended Device Connections by Interface 


Type of Interface 

Maximum Devices 
Per Card 

Maximum 

Cabling 

SCSI (Single-Ended) 

7 


SCSI (Differential) 

7 

25m^ 

SCSI (Fast-Wide) 

15 

25m^ 


a. Including internal cable length 
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Table 2-2 


Selecting Device Drivers for Your I nterface 
Cards 

The following sections describe each interface and their connectivity to 
peripherals. 

Asynchronous Data Communication Configuration 
Guidelines 

HP-UX multiplexers provide asynchronous data communication using 
protocols RS-232-C, RS-422, or RS-423 (depending on the card). All 
HP-UX computers areequipped with RS-232-C serial ports. Additional 
serial cards increasethe number of connections possible between the 
system processor unit (SPU) and terminals, modems, printers, and 
uninterruptible power system (UPS). Table 2-2, "Multiplexer 
Connectivity Configuration Requirements," summarizes the scope of HP 
cards, architecture, and drivers available. It also identifies the port 
modules (distribution panels) availablefor each serial card. 


Multiplexer Connectivity Configuration Requirements 


Card 

Ports, 

Protocol 

Architecture 

Device 

Drivers 

Available Port 
Modules 

(internal) 

RS-232-C 

2 ports 

Series 700 

asioO 

none 

(internal) 

RS-232-C 

3 ports 

Series 800 

asioO 

none 

98190A 

16-port 

MUX 

RS-232-C 

Series 800 

CIO 

muxO^ 

ADP 5062-3070 

28639-50 

001 

2-port 

MUX*’ 

Models 890, 
T500 

mux4‘^ 

none 
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Multiplexer Connectivity Configuration Requirements 


Card 

Ports, 

Protocol 

Architecture 

Device 

Drivers 

Available Port 
Modules 

40299B 

8-port 

MUX 

RS-232-C 
or RS-422 
d 

Series 800 
HP-PB 

mux2 ^ 

ADP 5062-3070 
ADP422 

5062-3085 

J2092A 

16-port 
RS-232-C ^ 

HP-PB 

mux2® 

DDP 5062-3066 
DDP 5181-2085 

RJ45 0950-2431 

J2093A 

32-port 

MUX 

RS423 or 

RS422 § 

HP-PB 

mux2® 

DDP 5062-3066 
DDP 5181-2085 

RJ45 0950-2431 

J2094A 

16-port 

MUX 

RS-232-C 

ri 

HP-PB 

mux2® 

MDP 5062-3054 

J2096A 

32-port 

MUX 

RS-232-C‘' 

HP-PB 

mux2® 

DDP 5062-3066 
DDP 5181-2085 

RJ45 0950-2431 

A1703-60 

003 

2-port 

MUX* 

Series 800 

Models 

E/G/H/I 

1110x4*^ 

none 

A1703-60 

022 

16-port 

MUXJ 

Series 800 
Models 

E/E/G/H/I 

mux2® 

MDP 5062-3054 
DDP 5062-3066 
DDP 5181-2085 

J2482A 

8-port 

EISA 

MUX 

D-class 

eisa_muxO 


J2483A 

64-port 

EISA 

MUX 

D-class 

eisa_muxO 

RJ45 J2484A 
DB25 J2485A 

RJ45 J2501A 
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Table 2-2 


Multiplexer Connectivity Configuration Requirements 


Card 

Ports, 

Protocol 

Architecture 

Device 

Drivers 

Available Port 
Modules 

J3592A 

8-port 

MUX PCI 

A-cIass, 

L-cIass, 

N-cIass 

Models B/C/J 

pci_mux0 


J2593A 

64-port 
MUX PCI 

A-class, 

L-class 

N-class, 

V-class, 

Models B/C/J 

pci_mux0 

RJ45 J2484A 
DB25 J2485A 

RJ45 J2501A 


a. Specifying muxO causes cio_caO, sio, pfail, and pa to be 
included in the kernel. 

b. The two ports can be used for console and remote console only; card 
also includes access port (AP). 

c. Specifying mux4 causes lanmuxO, lanttyO, sio, pfail, and pa 
to be included in the kernel. 

d. Card also includes console and access port (AP) 

e. Specifying mux2 causes sio, pfail, and pa to be included in the 
kernel. 

f Peripheral devices must be local (up to 15m distance); does not 
support modem signals. 

g. up to 1200m. 

h. Peripherals may be connected locally (up to 15m) using data and 
modem signals, or remotely using asynchronous modems. 

i. Personality card also includes AP, SCSI, LAN. The two ports of this 
card can be used for console and remote console only. 

j. Personality card also includes AP, SCSI, parallel. 

Distribution Panels for Asynchronous Connectivity 

Distribution panels (DDPs, ADP/M DPs) can be used to expand the 
connectivity between serial interface card and peripheral device. Data 
communications and terminal controllers (DTCs) provide additional 
serial connectivity for local or remote devices directly to the LAN. These 
mechanisms are illustrated in Figure 2-2, "Serial Connectivity via 
Distribution Panels or DTC." 
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Figure 2-2 Serial Connectivity via Distribution Panels or DTC 



Table 2-1, "Maximum Recommended Device Connections by I nterface," 
summarizes the distribution panels and their capabilities. All 
distribution panels listed provide connectivity for terminals, printers, 
and plotters. Those with full duplex modem control provide connectivity 
for modems also. 

Table 2-3 Distribution Panels 


Model 

Type of 
Distributi 
on Panel 

Compatible 

Protocols 

Complexity 

No. 

Ports, 

Connec 

tors 

Form 

Factor 

Duplex 

Modem 

Control 

0950-2431 

Direct 

(DDP) 

RS-232-C 

RS-423 

pass-through 

16 RJ45 

19in. 

rack- 

mount 

no 

5062-3054 

Modem 

(MDP) 

RS-232-C‘‘ 

added logic 

8DB25 

female 

10.25 X 
4.25in. 

yes 

5062-3070 

Active 

(ADP) 

RS-232-C'‘ 

added logic 

8DB25 

female 

10.25 X 
4.25in. 

yes 
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Table 2-3 


Distribution Panels 


Model 

Type of 
Distributi 
on Panel 

Compatible 

Protocols 

Complexity 

No. 

Ports, 

Connec 

tors 

Form 

Factor 

Duplex 

Modem 

Control 

5062-3085 

Active 

(ADP) 

RS-422'’ 

added logic 

8DB25 

female 

10.25 X 
4.25in. 

yes 

5181-2085 

Direct 

(DDP) 

RS-232-C‘‘ 

RS-423‘’ 

pass-through 

8DB25 

female 

19in. 

rack- 

mount 

no 

28659-60005 

Modem 

RS-232-C'‘ 

added logic 

6DB25 

female 

8.5 X 

4in. 

yes 


a. 3 pins; transmit, receive, ground. 

b. 4 pins; transmit, transmit ground, receive, receive ground 

c. formerly ADPII 

d. Used on CIO-based systems only. 

Data Communication and Terminal Controllers (DTC) 

Data communication and terminal controllers (DTCs) are stand-alone 
boxes that connect to the LAN to provide additional serial connections 
for local or remote devices. Unlike serial interface cards, which 
communicate directly with the core operating system, DTCs use 
Telnet-TCP/l P protocolstocommunicate with the peripheral devices. 
Therefore DTCs provide most, but not all, the same functionality. Two 
types of DTCs are available: 

< DTC 16MX telnet terminal server (J 2063A), providing direct 
connection for LAN, diagnostics, and up to 16 serial-connected 
peripherals. 

< DTC 16RX telnet terminal server (J 2064A), providing routable 
management in addition to direct connection for LAN, diagnostics, 
and up to 16 serial-connected peripherals. 

< DTC 72MX communications server (J 2070A), providing LAN, 
telnet access, X.25 access, and connection for up to 72 
serial-connected peripherals via an asynchronous processor board. 

DTCs must be configured by one of two DTC software products, H P 
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OpenView DTC Manager (HP part number D2355A) and HP DTC 
Manager/UX (HP part number] 2120A), both of which can be used with 
HP-UX systems. Consult your HP Sales Representative for full 
information. 

RS-232-C Cabling Guidelines 

For cabling purposes, serial devices may bethought of as Data 
Communications Equipment (DCE) or Data Terminal Equipment (DTE). 
Historically, DCEswere modems, and DTEs were whatever terminated 
the data path, typically a terminal at one end, and computer at the other. 
When transmitting remotely, the circuit may be shown diagrammatical ly 
as follows, with the active pins listed in Table 2-4, "DCE and DTE Pin 
Assignments." 

Computer[DTE]-{ DCE~~phone lines~~DCE }-[DTE] terminal 


DCE and DTE Pin Assignments 



DCE Pins 

DTE Pins 

Transmit^ 

3 

2 

Receive 

2 

3 

Monitor 

4,20 

5,6,8,22 

Assert 

5,6,8,22 

4,20 

Ground 

7 

7 


a. For simple serial I/O, only transmit, receive, and ground are required. 


Table 2-5, "RS-232-C I nterconnections," provides a quick reference to 
RS-232-C cabling between serial devices and an HP-UX system. Neither 
RS-422 nor direct CPU-to-CPU connections are tabulated. 

RS-232-C Interconnections 


Host Computer 
Connection “ 

Device 

Connection 

Cable Suggested 

DTE-4F 

DCE-25E 

Not recommended for DCEs. Use 92219T 

H- 17255=D. 

DTE-4F 

DTE-25F 

92219T 
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RS-232-C Interconnections 


Host Computer 
Connection ® 

Device 

Connection 

Cable Suggested 

DTE-4F 

DTE-25M 

92219T + 92224F adapter 

DTE-9F 

DCE-25F 

92221M, or 98561-61604 H- 40242M 

DTE-9F 

DTE-25F 

92221P, or 98561-61604 h- 40242G 

DTE-9F 

DTE-25M 

98561-61604 H-40242C 

DTE-9M 

DCE-25F 

24542M, or 98574-61606 H- 92221M, or 
98574-61606 h- 98561-61604 h- 40242M 

DTE-9M 

DTE-25F 

24542G, or 98574-61606 H- 92221P, or 
98574-61606 h- 98561-61604 h- 40242G 

DTE-9M 

DTE-25M 

24542H, or 98574-61606 H- 98561-61604 

H- 40242C 

DCE-25F 

DCE-25F 

40242G 

DCE-25F 

DTE-25F 

40242M or 92224M adapter, if cables 
present 

DCE-25F 

DTE-25M 

40242C or connect directly, if cables 
present 

DCE-25F 

DCE-25F 

92219Q 

DTE-25F 

DCE-25F 

40242M, or 92224M adapter, if cables 
present 

DTE-25F 

DTE-25F 

40242G 

DTE-25F 

DTE-25M 

17255D 

DTE-50F 

DCE-25F 

5061-4215 

DTE-50F 

DTE-25F 

5061-4216 H-92224M 

DTE-50F 

DTE-25M 

5061-4216 
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a. F denotes female receptacle; M, male plug. 4 denotes USOC RJ-11C 
connector (as on contemporary consumer telephones), 9 denotes 9-pin 
DB-0 subminiature D-style connector, 25 denotes 25-pin DB-25 
subminiature D-style connector, 50 denotes 50-pin amp "blue ribbon" 
D-style connector. 


Centronics (Parallel) Configuration Guidelines 

The centronics (parallel) interface allows characters to transfer over 
multiple data lines, one bit per line. This method of transfer results in 
faster speed than serial transmission and is preferred for configuring 
printers, plotters, and scanners. 

On Series 700 workstations, the centronics (parallel) interface is 
provided as a standard feature; Series 800 systems may have a parallel 
interface on the multi-functional I/O card (personality card) supplied 
standard with the computer or on an optional SCSI/Centronics interface 
card. Centronics is not supported on Series 800 Cl 0 systems. 


Centronics Configuration Requirements 


Architecture 

Interface card 

Interface Driver 

Series 700 Core I/O 

(internal) 

CentI 

Series 800 HP-PB 

28655A 

IprO 


a. Specifying Cent If causes ChrDrv to be included in the kernel. 


EISA Configuration Guidelines 

When configuring an interface card to the El SA bus, the eisa device 
driver must be present in the kernel, that is, it must be listed in 

/stand/system. 

Because El SA is a set of services used by other interfaces, configuring 
EISA cards is done differently than for other HP-UX interfaces. Refer to 
Appendix A , "EISA Board Configuration, "/sbin/eisa_config utility. 

Swapping to an EISA Device 

If you are adding a device to your system that you plan to use as a 
primary swap device, and the device will be connected to an EISA card. 
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you must perform the task in the foil owing order: 

Step 1. Shut down the system without changi ng the kernel (sti 11 swappi ng to the 
original swap device). 

Step 2. Add the EISA card and connect the new device. 

Step 3. Boot the system, which is still swapping to the original swap device. 
Step 4. Configure the kernel to swap to the new EI SA device. 

Step 5. Reboot the system. 

steps. If the new swap device is connected to an El SA card, it will be configured 
automatically by /sbin/eisa_config. Ifthe new card createsa resource 
conflict with EISA cards already configured, you must run eisa_config 
manually to resolve the conflict. If the new swap device is connected to 
an ISA card, you must run eisa_config manually to configure the new 
swap device. 

Graphics Card Configuration Guidelines 

The foil owing table shows the driver and device special files used by 
graphics cards and subsystems. 


Graphics Card Configuration Requirements 


Architecture 

Required 

Drivers 

Default Device Special Files 

Series 700 all 
models Series 800 
Models 8x9 

graphs^ 

/dev/crt /dev/crtO 
/dev/crtl /dev/crt2 
/dev/crt3/dev/ocrt 
/dev/ocrtO/dev/ocrt1 
/dev/ocrt2 /dev/ocrt3 


a. Specifying graphs causes wsio, ite, and framebuf to be included 
in the kernel. 


During system bootup, ioinit creates the default device special files 
shown in this table when it encounters the framebuf driver. 

If for any reason these device files are insufficient for your purposes, you 
can create new ones using mknod. As shown in 

/usr/conf/master.d/core-hpux, the major number for framebuf (the 
driver that provides the additional graphics capability) is 174 . A 
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character (raw) device special file is required. Usethe bit assignments 
shown for graphs interface driver in Table C-5, "Bit Assignments for 
Disk and Magneto-Optical Devices," in Appendix C , "Major and Minor 
Numbers," of this document. 

Graphics capabilities can be enhanced by installation of any of a growing 
family of cards and subsystems. Table 2-8, "Graphics E nhancement 
Capabilities," is intended only to give a rough idea of the possibilities 
available on HP workstations. Consult your HP Sales Representative for 
information targeted to your specific needs. 


Graphics Enhancement Capabilities 


Product 

Compatibility 

Provision 

98768A CRX 
subsystem 

Series 700 

Upgrades to CRX color 
graphics workstation 

A1439 24-bit Z Buffer 
and Graphics 
Accelerator card 

Models 720, 730, 
735, 750 or 755 

Converts CRX-24 workstation 
to a CRX-24Z conhguration. 

A2269A Dual CRX 
Graphics card 

Models 720, 730, 
735, 750, 755. 

Upgrades Model 750 or 755 
from dual CRX workstation to a 
quad-CRX (four-monitor) 
conhguration; provides 
connectivity for two graphics 
displays on a single card. 

A2270A/A2271A/A2 

272A 

Models 720, 730, 
735, 750, 755 

Upgrades Model 750 or 755 
CRX-24 to a dual CRX-24 
(two-monitor) conhguration. 
Upgrades Models 720, 730, 

735, 750, or 755 to CRX-24 
workstations. A2272A upgrades 
a Series 700 PVRX workstation 
to CRX-24 conhguration. 

A2666A CRX-48Z 
subsystem 

Models 735 or 755 

Upgrades from CRX-24Z to 
CRX-48Z conhguration. 

A2667A CRX-48Z 
subsystem 

Model 735 or 755 

Upgrades PVRX to CRX-48Z 
conhguration. 
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Graphics Enhancement Capabilities 


Product 

Compatibility 

Provision 

A2673A CRX-24 
subsystem 

Model 715 or 725 
EISA 

Upgrades to CRX-24 
configuration. 

A2674A 24-bit Z 

Buffer and Graphics 
Accelerator 

Model 715 or 725 

Upgrades a color workstation to 
a CRX-24Z configuration. 

A2675A CRX-48Z 
subsystem 

Model 715/50 or 

725 EISA 

Upgrades to CRX-48Z 
configuration. 

Z1 lOOA VideoLive 

card 

Series 700 EISA 

Provides live video output. 

A4070A HyperCRXS 
Graphics Adapter 

Series 700 GSE 

bus 

Provides double buffered 8-bit 
plane graphics with 8 overlay 
planes, color recovery 

A4071A HCRX24 
Graphics Adapter 

Series 700 

Provides 24-bit plane color with 

8 overlay planes. 

A4072A 3D 
accelerator 

Series 700 

Accelerates HyperCRX series 
graphics adapters. 

A4073A GSIC 

Model 715/100 

Allows CRX-48Z upgrade/use. 
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Graphics Cable Extensions 

The following extensions are availablefor placing theCRT a distance 
away from the SPU: 

46082A/B RGB extension 

46080/81A HIL extension 

1250-1287 Use three of these connectors to extend RGB cable for a 

Model 712. 

There is no PS/2 keyboard or mouse extension availablefor the Model 
712. 

Maintaining the Accuracy of Customized Graphics 
Configurations 

Any time you modify your graphics configuration, be sure to update the 
configuration files us^ by your application programs. 

For example, if you are adding a CRX24 (or CRX48) and using it as a 
console, you must 

Step 1. Note the hardware path in which you insert the card. 

Step 2. Identify the device special file for the CRX24. By default, the minor 
number of the console device special file is OxOOOOOO. 

Step 3. Make sure the files in the /etc/xii directory refer to the correct device 
special file for the console. 

Step 4. Change the console path in boot_admin to match the hardware path into 
which you insert the card. For example, 

BOOT_ADMIN> path console graphics2 

You can display the correlation between the PDC names and hardware 
paths by using the info query at the boot_admin prompt. 

Networking Configuration Guidelines 

HP Series 700 and 800 systems shipped with LAN ports on the 
personality (multi-functional) or core I/O boards provide network access 
through AUl LAN, ThinLAN, or EtherTwist. (Note, the two ports on the 
standard LAN personality card are mutually exclusive; you can use 
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either, but not both ports simultaneously.) 

Additional networking options are availablefor H P-UX systems. Table 
2-9, "Network I nterfaces and I nitial Configuration Requirements," 
summarizes their initial configuration requirements. 

All network products require a layered set of software — links, 
transports, and services— whose details fall beyond the scope of this 
document. Consult networking documentation for further information. 


Network Interfaces and Initial Configuration Requirements 


Card 

Supported Models 

Bus 

Architecture 

Drivers 

25567B 

LAN/9000 

Series 700 

EISA 

lan2 

28640 

LAN/9000 

Series 800 

HP-PB 

lan3 

J2159A 

X.25/9000 

Series 700 

EISA 

pdnO 

x25ip 

x25pa 

J2792A X.25 
Streams 

E/F/G/H/I-class, 
K-class, and T890 

HP-PB 

lapb 

x25plp 

x25sentrY 

x25idmap 

plp211c2 

trcl2 

trcl3 

synchal 

sxb 

sxbclone 

wan 

nioxb 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

J2794A X.25 
Streams 

B-class, C-class, 
J-class, D-class and 
Series 700 

EISA 

lapb 

x25plp 

x25sentry 

x25idmap 

plp211c2 

trcl2 

trcl3 

synchal 

sxb 

sxbclone 

wan 

eisaxb 

J2815A X.25 
Streams 

B-class, C-class, 
J-class, D-class, and 
Series 700 

EISA 

lapb 

x25plp 

x25sentry 

x25idmap 

plp211c2 

trcl2 

trcl3 

synchal 

sxb 

sxbclone 

wan 

syncio 

J3525A X.25 
Streams 

B-class, C-class, 
N-class, and V-class 

PCI 

lapb 

x25plp 

x25sentry 

x25idmap 

plp211c2 

trcl2 

trcl3 

synchal 

sxb 

sxbclone 

wan 

j3525 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

J3526A X.25 
Streams 

N-class, V-class, 
B-class, and C-class 

PCI 

lapb 

x25plp 

x25sentry 

x25idmap 

plp211c2 

trcl2 

trcl3 

synchal 

sxb 

sxbclone 

wan 

j3526 

36967A 

LANLink 

Series 800 

CIO 

cio_ca0 

lanO 

A2544A 

Apollo 

TokenRing 

Models 730, 750 

EISA 

tokenl 

J2104A, 
J2109A HP 
ISDN Link 

Series 700 

EISA 

isdnnetd 

isdnx25 

isdn 

isdnsn 

J2069A HP 
HIPPI Link 

Series 700 

EISA 

hippi 

J2146A 

LANLink 

Series 800 

HP-PB 

lan3 

J2157BFDDI 

Series 800 

HP-PB 

lan6 

B5502BA 

FDDL 

Series 700 

EISA 

fddiO 

A3659A 

FDDL 

Series 800, D-class 

EISA 

fddiO 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

A3722A 

FDDI 

K-cIass, T600-cIass 

HSC 

fddi3 

A3723A 

FDDI 

D-cIass, B-cIass, 
C-class, J-class 

HSC 

fddi3 

A3739A 

FDDI 

V-class, N-class, 
B-cIass, C-class, 
J-class 

PCI 

fddi4 

J2I65A HP 
TokenRing 
9000 

Series 700 

EISA 

tokenl 

J2I66A HP 

TokenRing 

9000 

Series 800 

HP-PB 

token2 

A5783A PCI 
TokenRing 

A-class, N-class, 
V-class, B-class, 
C-class, J-class 

PCI 

pcitr 

J2220A 

SNApIus 

Link"* 

Series 800 

HP-PB 

psiO 

sna_router 

sna_trace 

sna_access 

sna_NODE 

sna_SDLC 

sna_QLLC 

sna_LAN 

J2226A 

SNAplus 

Link“ 

Series 700 

EISA 

psil 

sna_router 

sna_trace 

sna_access 

sna_NODE 

sna_SDLC 

sna_QLLC 

sna_LAN 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

J2792A 

SNAplus2 

Link 

E/F/G/H/I-class, 
K-class, and T890 

HP-PB 

psiO 

sna_router 

sna_trace 

sna_access 

sna_NODE 

sna_SDLC 

sna_QLLC 

sna_LAN 

J2794A 

SNAplus2 

Link 

B/C/J-class, Series 
700, and D-class 

EISA 

psiO 

sna_router 

sna_trace 

sna_access 

sna_NODE 

sna_SDLC 

sna_QLLC 

sna_LAN 

A5783A 

SNAplus2 

Link 

N-class and V-class 

PCI 

pcitr 

A3525A 

SNAplus2 

Link (SDLC 
and QLLC 
starting 

R6.1100.100) 

B/C-class, N-class, 
and V-class 

PCI 

psiO 

sna_router 

sna_trace 

sna_access 

sna_NODE 

sna_SDLC 

sna_QLLC 

sna_LAN 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

A3526A 

SNAplus2 

Link (SDLC 
only starting 

R6.1100.100) 

N-class and V-class 

PCI 

psiO 

sna_router 

sna_trace 

sna_access 

sna_NODE 

sna_SDLC 

sna_QLLC 

sna_LAN 

A5483A 

ATM 

V-class, N-class, and 
L-class servers, 
BIOOO, C3000, and 
J5000 workstations 

PCI 

atm2pci 

A5513A 

ATM 

V-class, N-class, and 
L-class servers, 
BIOOO, C3000, and 
J5000 workstations 

PCI 

atm2pci 

A5515A 

ATM 

V-class and L-class 
servers, BIOOO, 
C3000, and J5000 
workstations 

PCI 

atm2pci 

J3420B ATM 

Models 743i, 744, 

748 

HSC 

atm2gsc 

J2469A ATM 

K-class, T600 

HSC 

atm2gsc 

J2499A ATM 

D-class, R380, and 
R390 servers, 

B-class, C-class, and 
J-class workstations 

HSC 

atm2gsc 

J2804A ATM 

E-class, F-class, 
G-class, H-class, 
I-class, T500-class 

HP-PB 

atmnio 

J2468A ATM 

K-class, T600 

HSC 

atm2gsc 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

J3573A ATM 

D-class, R380, R390 

HSC 

atm2gsc 

J3557A ATM 

V-class 

PCI 

atmpci 

A4919A 

Hyperfabric 

V-class 

PCI 

die 

A4920A 

Hyperfabric 

K-class 

HSC 

die 

A4921A 

Hyperfabric 

D-class 

HSC 

eiie 

A5506A 

4-Port 

100Base-TX 

A-class, R-class, 
N-class 

PCI 

btian 

B5509A 

A5230A 

1-Port 

100Base-TX 

A-class, B/C/J-class 

PCI 

btianS 

A5230A 

1-Port 

100Base-TX 

A-class, N-class 

PCI 

btianS 

J3850A 

1-Port Fast 

Ethernet 

T600 

HSC 

btiani 

A5172A 

1-Port 

100Base-FX 

V-class, N-class 

PCI 

btian6 

A3738A 

1-Port 

100Base-TX 

V-class, N-class 

PCI 

btian6 

H3514A 

2-Port Fast 

Ethernet 

K-class 

HSC 

btian4 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

J3516A 

2-Port Fast 

Ethernet 

D-class, 

B/C/JR-class 

HSC 

btlan4 

J3515A 

1-Port Fast 

Ethernet 

D-class, 

B/C/J/R-class 

HSC 

btlan4 

A3495A 

1-Port 

100Base-TX 

E/G/H/I/K-class, 

T500/T520/T600 

HP-PB 

btlanl 

A3658A 

1-Port 

100Base-TX 

D-class, B/C/J-class 

EISA 

btlanO 

A4308B 

1-Port 

100Base-TX 

Series 700 

EISA 

btlanO 

A4926A 

Gigabit 

Ethernet 

V-class, B-class, 
C-class, J-class 

PCI 

gel an 

A4924A 

Gigabit 

Ethernet 

K-class 

HSC 

gel an 

A4925A 

Gigabit 

Ethernet 

D-class 

HSC 

gel an 

A3404A 

Fibre Channel 

K-class 

HSC 

SCI-FI 

A359 IB Fibre 
Channel 

D-class, R-class 

HSC 

SCI-FI 

A3636A 

Fibre Channel 

Model T600 

HSC 

SCI-FI 
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Card 

Supported Models 

Bus 

Architecture 

Drivers 

A3740A 

Fibre Channel 

V-class, N-class 

PCI 

SCI-FI 


a. Obsolete models are shown for reference only. 


SCSI Configuration Guidelines 

Small Computer System I nterface (SCSI) is an ANSI standard for 
connecting computers and peripheral devices. H P Series 700 and 800 
computers support three implementations of SCSI-2, as shown in Table 
2-10, 'Types of SCSI and Characteristics." 

Types of SCSI and Characteristics 


SCSI Type 

SCSI 

Single-Ended 

SCSI 

Differential 

SCSI Fast/Wide 

Bus Support 

Series 700; 

Core I/O, EISA 
Series 800: 

CIO, HP-PB 

Series 700; 

Core I/O, EISA 

Series 700: Models 
735, 755 Series 

800: HP-PB, 890, 
T500 

Line Out 

Single line (plus 
ground) per 8 bits 

Two lines (plus 
ground) per 8 
bits; less 
susceptible to 
spikes; faster 
data 

transmission. 

Same as 

Differential, except 
bus width is 16 bits 

Bus Width 

8 bits 

8 bits 

16 bits 

(can run 8 bits) 


Table2-11, "SCSI Configuration Requirements," lists HP SCSI cards, the 
architecture on which they are supported, and the configuration 
requirements of the cards and attached SCSI devices. 
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SCSI Configuration Requirements 


Architecture 

Interface Card (SCSI Type) 

Interface Driver 

Series 700 EISA 

25525A/B (Differential) 

sctl^ 

Series 800 CIO 

27147A (Single-Ended) 

scsi2*’ 

Series 800 HP-PB 

28655A (Single-Ended) 

scsil^^ 

Series 800 HP-PB 

28696A (EastAVide) 

scsiS^^ 


a. Specifying sctl causes c700, c720, wsio, core, eisa, and eeprom 

to be included in the kernel. 

b. Specifying scsi2 causes cio_caO, sio, pfail, and pa to be 
included in the kernel. 

c. Specifying scsil or scsi3 causes sio, pfail, and pa to be included 
in the kernel. 

SCSI Addressing 

Up to seven single-ended SCSI or fifteen fast-wide SCSI devices can be 
configured to a single SCSI device adapter. Each device requires a 
unique bus address. 

• For single-ended SCSI, addresses range from 7 to 0 with 7 (highest 
priority) reserved for the adapter itself and 0 being the lowest 
priority. 

• For fast-wide SCSI, addresses range from 7 to 0 with 7 (highest 
priority) reserved for the adapter itself and 14 to 8 (lowest priority). 

Although most peripheral devices require only one address, the Optical 
Disk Library System (FI P C17xxA) uses three SCSI addresses (two for 
the magnet-optical drives and one for the autochanger picker). 

SCSI Cabling 

MultipleSCSI peripheral devicescan be connected to a single SCSI 
interface using a daisy-chain configuration. The final SCSI device in the 
daisy chain requires the proper terminator, discussed later in "SCSI 
Signal Termination." 


The SCSI bus should be kept as short as possible. Total cable length for 
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singleended SCSI must not exceed six meters. Total cable length for 
fast/ wide SCSI must not exceed 25 meters. These limitations include 
both internal and external cables, Refer to the documentation that came 
with your device for internal cable lengths. 

SCSI Cables 


Product 

Number 

Length 

Connectivity Description 

Adapter-to-Peripheral SCSI Cables 

K2296 

1.0 m 

High-density (HD) screw to low-density (ED) 
bail-lock male-male 

K229T 

1.5 m 

HD screw to ED bail-lock male-male 

Peripheral-to-Peripheral SCSI Cables 

92222A 

0.5 m 

ED bail-lock male-male 

92222B 

1.0 m 

ED bail-lock male-male 

92222C 

2.0 m 

ED bail-lock male-male 

SCSI Extender Cables 

92222D 

1.0 m 

ED male-female 

C2900A 

3.0 m 

ED bail-lock male-female ^ 

C2901A 

5.0 m 

ED bail-lock male-female*’ 

C2902A 

10.0 m 

ED bail-lock male-female*’ 

C2903A 

20.0 m 

ED bail-lock male-female*’ 

C2906A 

2.0 m 

ED male-male 


a. This product number is a replacement number for the SCSI cable 
included with the host adapter. 

b. Recommended for use with HP EISA cards. 

c. SCSI-II (50-pin) to SCSI-Ill (68-pin) cable, to connect Series 700 
workstations to C2425J/JK, C2427J/JK. 
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Cabling options can be ordered for the H P fast/wid^differential host 
adapter (H P 28696A) to extend standard cabling and for Switchover 
configurations (V-cables, male-male-male to daisy-chain multiple hosts). 
Table 2-13, "Fast/Wide SCSI Cables," shows additional cables available 
to connect a Fast/Wide SCSI adapter-to-peripheral or 
peri pheral-to-peri pheral. 

Fast/Wide SCSI Cables 


Product 

Number 

Length 

Product Compatibility 

C2911A 

0.9 m 

C2425JK, C2427JK, C3034T, C3035T, C3036T 

C2924A 

2.5 m 

C3034T, C3035T, C3036T 

C2925A 

10.0 m 

C3034T, C3035T, C3036T 

C2926A 

20.0 m 

C3034T, C3035T, C3036T 


The FI P 28643A SCSI Fiber-Optic Extender overcomes SCSI distance 
limitation to a maximum of 100 meters. Note, however, this device is 
single-ended SCSI and is recommended for printers, optical libraries, 
and magnetic tape drives only. It is not supported for Switchover 
configurations. 

SCSI cable impedance and construction have a significant impact on 
signal quality; use only FIP cables. 

Calculating SCSI Cable Length 

Table 2-14, "Example of SCSI Cable Length Calculation," demonstrates 
how to calculate SCSI bus cable lengths for a typical installation. 


Example of SCSI Cable Length Calculation 


Starting Point 
Device 

Cable to Next Device 

Internal 

Cable 

Cumulative 
Cable Length 

SCSI host adapter 

5062-338 

3 

1.0m 

0.1m 

1.1m 

HP device #1 

92222A 

0.5m 

0.2m 

1.8m 

HP device #2 

92222A 

0.5m 

0.4m 

2.7m 
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CAUTION 


Example of SCSI Cable Length Calculation 


Starting Point 
Device 

Cable to Next Device 

Internal 

Cable 

Cumulative 
Cable Length 

HP device #3 

92222A 

0.5m 

0.3m 

3.5m 

HP device #4 

none 


0.4m 

3.9m 

Total 



3.9m 


All devices must be connected to a common (single point) system 
reference ground. The system ground must be isolated from other 
electrical devices such as copying machines, arc welders and air 
conditioners. Cables supplied by HP have correct grounding. 

SCSI Signal Termination 

To successfully transmit signals, the SCSI bus requires that both ends of 
the bus be terminated. This statement means that the last device on the 
bus, no matter what type of device it is (disk, tape, or interface card), 
must have a terminator installed on its second SCSI connector. The 
terminator is (or acts as) a small resistor that provides matching 
impedance on the bus circuit. Without such termination, data traveling 
on the bus is likely to be corrupted and the protocol upset to the point 
that it hangs the bus. 

Some devices (particularly host adapters) contain internal SCSI bus 
terminators or require special terminators. If two devices supply 
termination power, locate them at each end of the SCSI bus. Refer to the 
specific hardware manuals of host adapters and the devices on the bus 
for instructions on how to prevent excessive or improper SCSI bus 
termination. 


Only the two ends of a SCSI bus should be terminated. Excessive or 
improper termination overloads the SCSI port's termination power 
(TERM PWR) circuitry. Overloading can result in blowing the 
TERM PWR fuse on the adapter, or damaging transceivers on any 
attached device, including the adapter. 


All HP SCSI products are shipped with appropriate terminators. Table 
2-15, "SCSI Terminators," should be helpful if you need to order 
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additional termination. 

SCSI Terminators 


Part 

Number 

Kind of Terminator 

No. Pins 

Application 

C2904A 

high-density w/ thumb screw 

50 

Active SCSI-II 

C2905A 

high-density w/ thumb screw 

68 

Active SCSI-Ill 

K2290 

low-density w/ thumb screw 

50 

Passive SCSI-II 

K2291 

low-density w/ bail connector 
(wide mouth) 

50 

Passive SCSI-II 


SCSI Parity 

All devices on a SCSI bus must be consistent in parity-checking 
capability. If any device on the SCSI bus does not generate parity, all 
devices on the bus, including the adapter, must not check parity. 
(Although parity-checking is selectable, the adapter always generates 
parity.) 

If a SCSI device cannot match the parity-checking capability of other 
devices on the bus, it must be installed on a separate SCSI bus. 

Changing the Bus Address of a SCSI Device 

Step 1. Shut down and halt the system using the /usr/sbin/shutdown -h 

command. On systems with powerfail mode, be sure to also turn off the 
battery backup. 

Step 2. TURN OFF the computer and unplug the power cord. 

Step 3. Turn off the device. 

Step 4. Change the bus ID on the device, 
steps. Turn on the device. 

Power on all SCSI peripherals and allow them to complete their selftest 
before powering on the SPU. 

Step 6. Turn on your system. 

Use of non-FI ewIett-Packard peripherals is not supported by 
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Hewlett-Packard's standard support process. 
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Configuring an Interface Card 

step 1. Determine the i nterface driver needed for your interface card by 

consulting the tables in "Selecting Device Drivers for Your Interface 
Cards". 

Look at your /stand/systemfiletosee if the required driver is present. 
(If you are also adding an external device such as a printer, consult the 
tables in the appropriate chapter and look for the presence of those 
drivers in /stand/system also.) 

If any necessary static driver is absent, you will need to rebuild the 
kernel to include it. 

Here is how to rebuild the kernel: 

a. Change directory to the build environment (/stand/build). There, 
execute a system preparation script, system_prep. system_prep 
writes a system file based on your current kernel in the current 
directory. (That is, it creates / stand/buiid/system.) The -v 
provides verbose explanation as the scri pt executes. 

cd /stand/build 

/usr/lbin/sysadm/system_prep -v -s system 

b. Modify the / stand/build/system file to add the absent driver(s) by 
invoking the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y 
driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 

description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


c. Build the new kernel by invoking the mk_kernei command. This 
action creates /stand/buiid/vmunix_test, a kernel ready for 
testing. 
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/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Prepare for rebooting by invoking the kmupdate command. This 
action sets a flag that tells the system to use the new kernel when it 
restarts. 

/usr/sbin/kmupdate 

Step 2. Notify users that the system will be shut down to configure the new 

interface card and any related peripheral device. You can use the wall 
command and/or the interactive capabilities of the shutdown command 
to broadcast a message to users before the system goes down. See wal I 
(IM) or shutdown (IM) in the HP-UX Reference 

Step 3. Bring the system to a halt, using the shutdown command. 

Step 4. Turn off the power to all peripheral devices and then to the SPU. On 

systems with powerfail mode, turn off the battery back-upalso. Unplug 
the power cords. 

Step 5. Select an appropriate slot in the I/O card cage and install the interface 
card, following instructions provided with the card and computer 
hardware manual. 

If you are also configuring a peripheral device to the card, install it at 
this time also. Use the cabling recommended in the hardware 
documentation. 

Step 6. Record all pertinent information about the installation and configuration 
on a worksheet at the back of this document. Keep accurate records of 
the interface (as shown on the ID stickers), slot number, power 
requirements, and bus address. 

Step 7. Turn on the power to all peripheral devices. Wait for them to become 
"ready", then turn on power to the card cages and SPU. 

On booting up, H P-UX detects the new interface and peripheral device 
and associates them with their device drivers, insf creates the device 
special files required to communicate with the devices. 

Step 8. Verify the configuration by invoking the loscan command to confirm 
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that the interface card (and any peripheral devices you configured) are 
present and device special files have been created. 

I n the foil owing sample ioscan output, the LAN card installed in slot 14 
of a Model 887 is displayed as hardware path 56 (slot number times 4). 

/usr/sbin/ioscan -C lanmux -f 

Class I H/W Path Driver S/W State H/W Type Description 


lanmux 0 56 lanmuxO CLAIMED INTERFACE LAN/Console 

For more information on using ioscan, consult Chapter 1, "Getting 
Started,"and the ioscan (IM) manpage. 
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For Further Information on Interface Cards 

For information on any device drivers, consult the Section 7 manpages in 
the HP-UX Reference most of which deals with interfaces. 

For further information on DTCs, consult the following manpages in the 
HP-UX Reference: 

dp (4) Dedicated ports file, used by DDFA and DTC port ID 

ddfa (7) DTC device file access software 

Another useful resource for RS-232-C connectivity is the Racking and 
CablingGuidefor DTCs, HP part number 5961-0373. 

For information on graphics configuration and use, consult the HP 
Starbase, X Windows, and RTAP/Plus documentation sets, as well as any 
other documentation pertinent to the application programs you are 
running. 
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Configuring Terminais and 
Modems 


This chapter contains the procedures for configuring terminais and 
modems to seriai (RS-232-C) ports. 

For H P-UX to communicate with aterminai or modem, thefoiiowing 
conditions must be met: 

• The seriai device driver required to communicate with the device 
must be part of the kernei. 

• Theterminai or modem must be physicaiiy attached and configured 
to the port. 

• A device speciai fiie must be created to communicate through the 
port. 

• A getty process must be run against the (terminai) port to soiicit 
iogins. 

For procedures on configuring terminais and modems attached to Fi P 
terminai controiiers (DTCs) on the network, refer to thefoiiowing 
resources: 

• U si ng the H P DTC M anager/ U X (part number J 2120-62000), for 
managing terminais and modems from a host FiP-UX system. 

• Using FiP OpenView DTC Manager (part number D2355-90001), for 
managing terminais and modems from a personai computer. 

• documentation accompanying your third-party terminai server. 
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Planning to Configure a Terminal or Modem 

Plan ahead before configuring a terminal or modem. Read the hardware 
documentation shipped with the peripheral device and understand what 
you need to do before getti ng started. 

Planning to Configure a Port for a Terminal 

Consider the following: 

• Are you configuring the device directly to a serial (RS-232-C) port or 
to a termi nal server through the LAN ? 

• Will other users be affected by the configuration? If so, notify them 
before you bri ng the system down. 

• Observe H P recommendations concerning maximum recommended 
cabling distances and maximum number of terminals per interface. 

• Decide whether you will be running uucp on the device. 

• I nvoke /usr/sbin/ioscan -f before beginning your configuration to 
figure out to which interface card or MUX you are adding the 
terminal or modem. Note which ports are already used. Attempt to 
distribute the peripherals among your cards, if possible. 

HP systems are shipped so that you can use the HP console terminal 
immediately after plugging it into an SPU. 

The simplest way to configure any H P terminal or a modem is to use the 
System Administration Manager (/usr/sbin/sam). SAM's 
self-explanatory menus and help system prompt you for all the software 
requirements, to ensure the termi nal or modem is configured properly 
and with appropriate security settings. If SAM is not loaded on your 
system or if you prefer to use the command-line interface, the following 
procedure will guide you through the task. Familiarizeyourself with the 
instructions before getting started. 

Planning to Configure a non-HP Terminal 


As of 10.0, HP provides limited support for non-HP terminals. Their 
configuration and limitations arediscussed in the section, "Configuring a 
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Non-HP Terminal as a Console", later in this chapter. 


The following non-standard terminal emulations are provided for 
HP-UX: 

• DEC VTIOO, VT320 

• VT420 terminals in VTIOO or VT320 modes 

• Wyse 60 

• HP terminal 700/60 in VTIOO, VT320, and Wyse60 modes. 

Note, the less expensive DEC and Wyse terminals lack certain 
capabilities standard to full-featured HP terminal firmware. See 
"Limitations to Non-HP Terminal Emulation"for information on the 
differences. 

Planning to Configure a Port for a Modem 

To add a modem to an H P system, you need to configure both the serial 
port for H P-UX to recognize the modem and the modem's protocol. 
Regardless of whether you configure using SAM (recommended) or 
HP-UX command-line interface, read the procedure and modem 
documentation beforehand. 

Consider the following choices: 

• The hardware path (including port number) of the serial interface to 
be used by the modem. You can identify potential ports by invoking 

/usr/sbin/ioscan -C tty Or list /dev/ttyxp*, where x is the mux 

card instance and p* shows all existing ports. 

• The modem's baud rate. 

• Whether the modem will be used for outgoing calls. 

• Whether the modem will receive incoming calls. 

• Whether the modem requires CCITT (required only by certain 
European government protocols). For standard Hayes-compatible 
modems that useCCITT modulation and compression standards, do 
not useCCITT mode. See modem (7) for details of RS-232-C signaling 
characteristic of simple and CCITT modems. 

• Whether you need to configure for UUCP connectivity. 
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You will need to create device special files with /usr/sbin/mksf 
specifically for modem use. 

mksf provides options for CCITT for special European protocol 
requirements (most US customers should not use the CCITT option), -i 
option for a UUCP dialer (used with access mode 0), and hardwareflow 
control (an alternative to XON/XOFF pacing). The mksf options for the 
asioO device driver allows for incoming and outgoing hardware 
buffering. 

An example of creating modem device special files is provided in 
"Additionally Configuring FIP-UX for a Modem", later in this chapter. 

Seethe mksf (IM), modem (7), and termio (7) manpages in the FI P-UX 
Reference for bit values and use. Also review "Requirements for Modems 
to Work on FI P-UX" to ensure proper functioning. 
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Table 3-1 


Selecting Device Drivers for Terminals and 
Modems 

UseTable3-l, "Serial Configurations for Terminals and Modems," on the 
next page to identify the interface and device drivers required to 
configure a terminal or modem to a serial port. 

For information on increasing the number of available serial ports, see 
Table 3-1, "Serial Configurations for Terminals and Modems." 


Serial Configurations for Terminals and Modems 


Architectur 

Interface 

Cards 

Drivers 

Device Files 
(for terminals 

H/W Flow 

Control 

Series 700 

(internal) 

asioO 

/dev/mux# 

/dev/tty#p# 

d 

Yes 

Series 800 

CIO 

98190A 

98196A 

muxO® 

(same as 
above) 

No 

Series 800 

HP-PB 

40299B 

J2092A 

J2093A 

J2094A 

J2096A 

A1703-6002 

2^ 

inux2® 

(same as 
above) 

40299B - No 

J2092A - No 

J2093A - No 

J2094A -Yes 

J2096A - No*’' 

Series 800 

HP-PB 

A1703-6000 

3 j 

28639-6000 

if 

mux4'^ 

(same as 
above) 

No 


a. The following terminals are supported for HP-UX; C1006A/GAV, 
C1007A/G/W, C1017A/GAV, C1064A/G/GXAVAVX, C1065A/GAV, 
C1080A/G/W, C1083W, C1084W, C1085W, VTIOO, VT320, WYSE60, 
700/60, 700/96, 700/98. HP-UX supports numerous third-party 
modems. 
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b. Device special files for modems are not created by default. See Table 
3-7, “Device Special Files for Modems,” for information on creating 
them using mksf 

c. See termio (7) and termiox (7) for information. 

d. mux# and tty#p# derive from ioscan output; The numeral after mux 
and tty is the card instance for the tty class of interface card to which 
the terminal is connected; the numeral after p is the port number of the 
serial interface. 

e. Specifying muxO causes cio_caO, sio, pfail, and pa to be included 
in the kernel. 

f. The A1703-60022 and 28639-60001 personality cards are used for 
console connection. 

g. Specifying mux2 causes sio, pfail, and pa to be included in the 
kernel. 

h. J2092A and J2096A do not support modems. 

i. Hard ware flow control is supported on the A1703-60022 for the first 
eight (of 16) ports only. 

j. Personality card used for console and remote console connection. 

k. Specifying mux4 causes lanmuxO, lanttyO, sio, pfail, and pa to 
be included in the kernel. 
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Configuring HP-UX for an HP Terminal or for 
a Modem 

step 1. Determine which driver is required for the terminai or modem by 

consuitingTabie3-l, "Seriai Configurations for Terminais and Modems." 

Step 2. Determine whether the driver is present inthekernei by invoking the 
command, /usr/sbin/ioscan -fn 

-c tty, from the system consoie or any login to the system usi ng an 
active terminai. 

• If the necessary driver is present in the kernel (iikeiy), the 
ioscan output of a Series 700 might resembie this: 

/usr/sbin/ioscan -d asioO -fn 

Class I H/W Path Driver S/W State H/W Type Description 


tty 0 2/0/4 asioO CLAIMED INTERFACE Built-in RS-232-C 

/dev/ttyOpO 

tty 1 2/0/5 asioO CLAIMED INTERFACE Built-in RS-232-C 

/dev/ttyIpO 

Simiiariy, the ioscan output of a Series 800 system might resembie 
this: 

/usr/sbin/ioscan -d mux4 -fn 

Class I H/W Path Driver S/W State H/W Type Description 


tty 0 56/0 mux4 CLAIMED INTERFACE MUX 

/dev/diag/muxO /dev/diag/ttyOpO /dev/ttyOpO 

/dev/diag/ttyOpl /dev/muxO /dev/ttyOpl 

The-fn option caused ioscan to dispiay the device speciai fiies 
created by insf. insf automaticaiiy creates device speciai fiies 
appropriate for terminais at each seriai port. The sampie device 
speciai fiie highiighted communicates with port 1 (pi) of the MUX 
card found at card i nstance 0 of tty dass. 

You can dispiay the devicefiie's characteristics by invoking 
/usr/sbin/issf on the fiie. By comparing issf and ii output, you 
can see that bits 16 to 23 of the minor number (OxOOOiOO) correspond 
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to the port number of i. (See Appendix C for explanation of bit 
assignments.) 

/usr/sbin/lssf /dev/ttyOpl 

mux4 card instance 0 port 1 hardwired at address 56/0 /dev/ttyOpl 

11 /dev/ttyOpl 

crw-rw-rw- 1 bin bin 178 0x000100 Mar 16 18:29 /dev/ttyOpl 

— I f you are configuri ng a termi nal without havi ng to i nstal I an 
interface card, you can physically connect the termi nal, as 
described in its owner's manual. Then, skip ahead to "Additionally 
Configuring H P-UX for a Terminal", the next section. 

— If you are configuring a modem to an existing port, note the 
hardware address (or card instance number) and port number you 
wi 11 be usi ng from the ioscan output. Then, ski p ahead to 
"Additionally Configuring HP-UX for a Modem", later in this 
chapter. 

< If the necessary driver is not present in the kernel, and is a 

static driver, you will need to rebuild the kernel to includethe 
additional driver. If the driver is a dynamic driver, no rebuild is 
necessary. (This situation might occur if you have to add hardware to 
configure additional terminals or if you are running a minimal 
kernel.) 

Step 3. To rebuild your kernel and include an additional driver, here is what to 
do: 


a. Identify the needed driver by consulting thetablein "Selecting Device 
Drivers for Terminals and Modems", earlier in this chapter. 

b. Change directory to the build environment (/stand/build). There, 
execute a system preparation script, system_prep, which extracts the 
system file from the cur rent kernel and writes a system file in your 
current directory. (That is, it creates /stand/buiid/system.) The -v 
provides verbose explanation as the scri pt executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

c. Modify the/stand/build/system fileto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 
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NOTE To avoid introducing format errors, do not edit the HP-UX system 

description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


d. Build the new kernel by invoking the mk_kernei command. This 
action creates /stand/buiid/vmunix_test, a kernel ready for 
testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

e. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

f. Prepare for rebooting by invoking the kmupdate command. This 
action sets a flag that tells the system to use the new kernel when it 
restarts. 

/usr/sbin/kmupdate 

Step 4. Bring down the system with sufficient grace period to allow users to exit 
their files. You can execute /usr/sbin/shutdown -r or 
/usr/sbin/reboot. 

If you are installing an interface card, bring the system to a halt (that is, 
use the -h option). See shutdown (IM) or reboot (IM) in the HP-UX 
Reference Power off all peripherals, and then theSPU. Perform the 
physical installation, as described in the hardware manual 
accompany!ng the interfacecard or other device. Power on all 
peripherals, and then theSPU. 

Once the system boots from the newly created kernel, HP-UX detects the 
new terminal and associates it with its driver, insf automatically 
creates the device special files necessary to communicate directly with 
the terminal. 

Step 5. I nvoke/ usr/sbin/ioscan 

-c tty -fn toconfirm that the I/O subsystem finds the terminal. Your 
output should now resemble the ioscan output shown in step 2. 

Step 6. Proceed to "Additionally Configuring HP-UX for aTerminal"or 
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"Additionally Configuring H P-UX for a Modem" (later in this chapter), 
depending on which device you are configuring. 
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Additionally Configuring HP-UX for a 
Terminal 

The previous procedure ensured the system side was set up properly; 
now you are setting up the terminal side. 

• If the terminal will be used as a console, the default configuration is 
likely to be correct. 

• If the terminal will not be used as a console (but rather as an 
additional serial terminal), you might have to set configuration 
modes. 

Step 1. From the new terminal, use the function keys to set the terminal's 
features. In most cases, default settings will be sufficient. 


NOTE Newer terminals have default modes correct for communicating with 

HP-UX. If you areuncertain theterminal isconfigured in default mode, 

1. Power off theterminal. 

2. Hold D key down while powering on. 

Theterminal will power on with correct default modes. Make any 
adjustments that might be necessary. 


Step 2. Add a getty entry for each new terminal in /etc/inittab. Entries must 
conform to the pattern id:run_state:action:process, as documented 
on theinittab (4) manpage. A sample terminal entry resembles the 
following: 

ttp3:2:respawn:/usr/sbin/getty -h -t 60 tty0p3 9600 

• ttp3 Isa label used by init to identify the action uniquely (see I nit 
(IM)). 

• The 2 is the run state. Systems are shipped with the multi-user run 
state (seethe initdefauit entry in inittab). When the system is 
running in single-user mode (state s), this process is not executed. 

• The respawn tells init to restart the process if it exits. 
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• The /usr/sbin/getty is the process used to set up serial terminal 
and modem ports and provide the initial login prompt. 

• The -h option ensures that the getty will not hang up the line before 
setting the port speed. 

• The-t 60 is a security option to require that the user login name and 
password is typed within 60 seconds. 

• ttyOpS identifies the port in /dev to which the getty attaches. 

• The 9600 (highlighted) does not represent the baud rate. It is a 
pointer into the /etc/gettydefs file, tel ling the system side what 
entry to use. An h entry is also provided for hard-wired terminals. See 
gettydefs (4). 

Step 3. I nvoke the following command to activate the updated /etc/inittab 
file: 

/sbin/init q 

Step 4. Add an (optional) entry to /etc/ttytype. Entries should conform to the 
format documented on thettytype(4) manpage. I n the following example, 
2392 isthe terminal type; console and tty0p3 are the device file names 
in the /dev directory. 

2392 console 
2392 ttY0p3 

Step 5. Now that H P-UX is set to communicate with the new terminal, verify 

that the communication parameters for the terminal correspond to their 
/etc/gettydefs entries. I nstructions on necessary changes will be 
discussed in "Differences between ConsoleandTerminal Configuration", 
the next section. 

Step 6. With the configuration complete, your terminal should display a login 
prompt. If no login is displayed, press Return several times. If a prompt 
fails to appear, consult the'Troubleshooting Terminal Problems" toward 
the end of this chapter. 

Differences between Consoleand Terminal 
Configuration 

Asshipped, HP terminals are configured properly for use as a system 
console. To use the terminal as a serial terminal, the parameters shown 
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Table 3-2 


inTable3-2, "Key Terminal Configuration Parameters," might require 
configuration in /etc/gettydefs. 

Key Terminal Configuration Parameters 


Parameter 

Console (as 
shipped) 

Serial Terminal 

(hard-wired) “ 

Serial Terminal (via 
modem) 

Data bits 

8 

8 

7 

Parity 

no 

no 

even 

Default speed 

9600'’ 

9600 

300*’ 


a. These are the parameters set for the H entry in /etc/gettydefs, 
and can be used for terminal configuration in /etc/inittab. 

b. Sending a Break will cause the speed to change in the sequence shown 

in /etc/gettydefs. 


Running Screen-Oriented Applications on a Terminal 

To run screen-oriented applications (such as SAM or swinstaii) on a 
terminal that is not being used as a console, you can use the h setting in 
/etc/gettydefs. As shown in Table 3-2, "Key Terminal Configuration 
Parameters," this will give you 8 data bits and no parity, which are 
required by screen-oriented applications. 

Step 1. Edit the getty entry in /etc/inittab so that the device special filefor 
the terminal points to then entry in /etc/gettydefs. 

ttp2:234:respawn:/usr/sbin/getty -h tty0p2 H 

Step 2. Reissue the /sbin/init 

q command to activate the updated /etc/inittab file. 

Seegettydd's (4) in the HP-UX Reference 

Configuring a Non-HP Terminal as a Console 

HP supports Wyse 60 terminals with nativeASCII keyboards, VT320, 
and VTIOO compatible (as defined by DEC VT420) terminals, in their 
default power-on configuration as system consoles for H P 9000 Series 
800 E Family computers. Also, H P 700/60 terminals can be configured to 
emulate the non-HP consoles. Only HP terminals are supported as 
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system consoles on other H P 9000 Series 800 computers. 

Two HP MUX interface modules support configuration of a non-HP 
terminal console, provided you have the correct firmware version: 

• Access port MUX16 (part number A1703-60022 for Series 800 H P-PB) 
with firmware version Rev 2.30 datecode 3341. (If you installed the 
card, you should have recorded the firmware revision on a worksheet 
in Appendix D , "Worksheets.") 

• The access port MUX module integrated into the core I/O card of 
Model I computers. 

If you are configuring a non-HP terminal or terminal emulation, proceed 
through the instructions provided in the following sections, and note the 
limitations described in "Limitations to Non-HP Terminal Emulation". 

Configuring a DEC 420Terminal to Emulate VT100 or VT320 
Mode 

The DEC VTIOO and VT320 terminals will work in their default settings 
with H P-UX. For a VT420 terminal to work in H P-UX, it must be 
configured to emulate either a VTIOO or VT320 terminal, as follows: 

Step 1. I nstal I the hardware, as descri bed i n the termi nal's manual. 

Step 2. E nter set-up mode by press! ng the F3 key. 

a. Select Default and press Return. 

b. Select General and press Return. 

c. Set the Mode. 

• To emulate a VT320, select VT400 Mode 7 bit Controls. 

• To emulate a VTIOO, press Return until theselection reads "VTIOO 
Mode." 

d. Set the ID. 

• To emulate a VT320, select VT320 ID. 

• To emulate a VTIOO, select VTIOO ID. 

e. Return to the main settings and save the configuration. Then press 
the F3 key to exit set-up mode. 

Table 3-3, "Configuration Values for vtlOO Compatibility," shows the 
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correct values for a Model VT420 terminal set up to emulate a VT100. 

Table 3-3 Configuration Values for vtlOO Compatibility 


Global Set-Up 

On-Line 

SI-Comm 1 

CRT Saver 

Printer Shared 

70 Hz 

Display Set-Up 

80-Columns 

Interpret Controls 

No Auto Wrap 

Smooth-2 Scroll 

Dark Screen 

Cursor 

Block Cursor Style 
No_Status_Display 
Cursor_Blink 

6x24 Pages 

24 Lines/Screen 

Vertical Coupling 

Page Coupling 

No Auto Resize Screen 

General Set-Up 

VTIOO Mode 

VTIOO ID"* 

Printer Set-Up 

Speed=4800 

No Printer to Host 

Normal Print Mode 

XOFF 

8 Bits, No Parity 

1 Stop Bit 

Print Full Page 

Print National Only 

No Terminator 
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Table 3-3 Configuration Values for vtlOO Compatibility 


Communications 
Set-Up Comml 

Transmit=9600 

Receive=Transmit 

XOFF at 64 

8 Bits, No Parity (console) 1 
Stop Bit (console) 

No Local Echo 

Data Leads Only 

Limited Transmit 

No Auto Answerback 

Answerback= 

Not Concealed 

Keyboard Set-Up 

Caps Lock 

Auto Repeat 

Keyclick High 

Margin Bell Off 

Warning Bell High Character 
Mode 

<X Backspace *’ 

Local Compose 

Ignore Alt 

F1=Hold 

F2=Print 

F3=Set-Up 

F4=Session 

F5=Break 
,< and ■> Keys 
<> Key 
'-Key 

Tabs Set-Up 

8 spaces apart, starting in 
column 9 


a. The mode and ID can be VTIOO or VT320, 
depending on which model is being emulated. 

b. You may need to conhgure this key from Delete 
to Backspace. To do so, use the stty command 
as follows: stty erase <backspace_key>. 

Your VT420 terminal is now configured for use as an H P-UX system 
console. PI ease be a ware that the configuration is based solely on the 
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Table 3-4 


VTIOO default configuration. 

You may notice the following differences between the DEC VTIOO, 
VT320, or VT420 terminals and an HP terminal: 

Unique Definitions of VTIOO Keys 


Key 

Meaning 

Backspace 

Sends Delete character (octal \177) instead of 
Backspace 

Alt Char 

Escape 

Er Line 

New Line or Line Eeed 

F1-F5 

(Consult DEC manual for captive meanings) 

F6 (Inter/Halt) F7 
(Resume) 

F8 (Cancel) 

F9 (Main Screen) 
F10 (Exit) 

F15-F20 

FindSelect 

Remove Insert 

Here PrevNext 

Inoperative in vt 10 0 mode 


Using an HP 700/60Terminal in DEC Mode 

If you have reason to use an HP 700/60 termi nal in DEC-emulation 
mode, you might wish to change the operation of the Backspace key. You 
can do so by using the HP 700/60 terminal's set-up menu. 

Step 1. Enter the Setup menu and proceed to the Keyboard Configuration menu. 

Step 2. Set the Backspace key from Delete to Backspace. 

Step 3. Save the Keyboard Configuration. 

Step 4. Log out, then log back in again. Your keyboard will now be set to erase 
characters correctly. 

By default, the backspace key on both DEC terminals and emulation is 
configured as DEL, echoes on the screen, and does not erase. To set 
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the key to erase, execute an stty command as follows: 

stty erase 

I nput the ^ and ? characters as separate keystrokes and be sure to 
enclose them in quotation marks. 

H P 700/60 terminals in VT320 mode uses control-H for backspace. 

You can set this up in your .profile or .login file. 

Configuring the VUyse 60Terminal 

Configure the Wyse 60 terminal for use as an HP console by executing 
the following set of instructions: 

Step 1. I nstal I the hardware, as descri bed i n the termi nal's manual. 

Step 2. Configure HP-UX to use the Wyse 60 terminfo file to communicate with 
the terminal. To do so, set the term variable to wyeo by executing the 
following command for Posix or Korn shell: 

export TERM=wy60 

Your Wyse 60 terminal is now configured for use as an H P system 
terminal. Please be aware that the configuration is based solely on the 
Wyse 60 default configuration. If further adjustment is required, use the 
terminal values provided in Table 3-5, "Wyse 60 Default Configuration 
Values." 


VUyse 60 Default Configuration Values 


Display F1 

Columns 

80 


Lines 

24 


Page Length 

l*Lines Char 


Attributes 

Standard Jump 


Status Line 

Blink Block 


Scroll Speed 

Off 


Cursor 

Dark 


Answerback Mode 

On 


Background 

On 


Screen Saver 

Display Cursor Answerback 
Conceal 

Off 
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VUyse 60 Default Configuration Values 


General F2 

Personality 

Comm mode Data/Printer 
Rcvd CR 

Enhance End-of-Line-Wrap 
Auto Scroll 

Monitor 

Eont Load 

Send Ack 

Init Tabs 

Width Change Clear 

Wy60 

Pull Duplex 
Modem/Aux 

CR 

On 

On 

On 

Off 

On 

On 

Off 

Off 

Keyboard F3 

Keyclick 

On 


Return 

CR 


XMT Limit 

None 


Wyse Word 

Off 


Keylock 

Caps 


Enter 

CR 


Ekey Xmit Limit Language 

No 


Key Repeat 

US 


Corner Key 

On 


Break 

Punct 


Margin Bell 

250 ms 

Off 

Comm F4 

Baud Rate 

9600 


Rev Handshake 

None 


Aux Baud Rate 

9600 


Aux Rev Handshake 

DSR 


Data/Stop Bits 

8/1 


XMT Handshake 

None 


Aux Data/Stop bits 

8/1 


Aux Xmt Handshake Parity 

None 


XPC Handshake 

None 


Aux Parity 

Off 

None 
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Table 3-5 


VUyse 60 Default Configuration Values 


Misc F5 

Block End 

Auto Page 

TVI955 Attribute 

VPGO Blk End 

Labels 

Save Labels 

Page Edit 

WPRT Intensity 

WPRT Reverse 

WPRT Underline 

Test 

us/cr 

Off 

No Space 

None 

Off 

Off 

Off 

Normal 

Off 

Off 

Off 

Tabs F6 

Tabs 

(undefined) 

Answerback 

F7 

Answerback 

(blank) 

FKeys F8 

All EKeys definition 

(undefined) 

FKey Labels 

F9 

All EKey labels 

(undefined) 


Limitations to Non-HP Terminal Emulation 

Non-HP terminal support has limitations to usage, particularly in the 

area of keyboard differences. Observe the following: 

• The CUE startup screen will work with non-HP terminals only if the 
-T option is used with cuegetty (see cue(1) and cuegetty (IM) in the 
H P-UX Reference). 

• All H P terminals use screen buffers for the page-up/Prev and 
page-down/Next functions. Non-HP terminals and terminal 
emulations do not provide these keys; they rely on applications to 
handle them. 

VUyse60Emulation Limitations 

• The Wyse 60 overloads the meaning of various ASCI I control 
characters. As a result, the behavior of some control characters may 
not be as the user expects. 

• Use the DEL key (located next to Backspace) to backspace. I fusing 
H P 700/60 with a PC-AT keyboard in Wyse60 mode, the DEL key is 
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Table 3-6 


located in the bottom row of the number pad. 

• Unlike HP terminals, which provide two lines, Wyse 60 terminals 
provide a single line to display softkey labels. Sometimes, this may 
result in truncated softkey labels. For example, the "Help on Context" 
label for FI might appear as "Help on C." 

DEC VT-Series Limitations 

• Two different kinds of keyboardsareavailablefor DEC terminals— a 
DEC/ANSI keyboard with programmable function (PF) keys and a 
PC-AT keyboard, which does not provide programmable function 
keys. 

The function keys Flthrough F 4 on the DEC/ANSI keyboard are 
preassigned. Different keys are used for its programmable function 
(PF) keys. Certain applications, such as Dialog Manager based 
applications, will remap some of the keys. Other commands may or 
may not have any keyboard remapping. 

The DEC PC-AT keyboard does not provide PFl, PF2, PF3, or PF4 
keys. PF4 can be mapped on a DEC PC-AT keyboard to the - key. 

Table 3-6, "Function Key Mappings," compares use of function keys 
on the DEC/ANSI keyboard, DEC PC-AT keyboard, and an H P 
keyboard. (Function keys on Wyse keyboards are consistent with H P 
keyboards.) 


Function Key Mappings 


HP or 
Wyse60 

DEC/ANSI 
keyboard in 

VTIOO or 

HP700/60 in 

VTIOO mode 

DEC/ANSI 
keyboard in VT320 
or HP700/60 in 
VT320 mode 

DEC PC-AT 
keyboard 

FI 

PF2 

PF2 

/ key 

F2 

PFl 

PFl 

NumLock 

F3 

space bar 

space bar 

space bar 

F4 

PF3 

PF3 

* key 

F5 

return 

FIO, [exit] 

F5 

F6 

none 

none 

none 
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Table 3-6 


Function Key Mappings 


HP or 
Wyse60 

DEC/ANSI 
keyboard in 

VTIOO or 

HP700/60 in 

VTIOO mode 

DEC/ANSI 
keyboard in VT320 
or HP700/60 in 
VT320 mode 

DEC PC-AT 
keyboard 

F7 

none 

F18 

first unlabeled key 
to right of 
Pause/Break 

F8 

none 

F19 

second unlabeled 
key to right of 
Pause/Break 


• Many applications use Tab for forward navigation and ShiftTab for 
backward navigation when moving from one field to another. Users 
having DEC terminals or using terminals in DEC emulation modes 
will find that these two actions are indistinguishable. Therefore, you 
must navigate in a circular fashion to return toa desired field (that is, 
Tab forward through the menus). 

• DEC terminals do not support softkey menus; thus, no such menus 
aredisplayed on these terminals. 
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Table 3-7 


NOTE 


Additionally Configuring HP-UX for a Modem 

step 1. If you are configuring a modem to the single modem port on a Series 800 
multi-function card, you need to ensure that the modem port is not 
locked. 

Step 1. Execute a control-B on the console to get into command mode. This will 
give you a cm> prompt. 

Step 2. Execute a ur command to unlock the remote access port. 

Step 3. Execute a dr command to disable the remote access port. 

Step 4. Execute a co command to return to the console mode. 

steps. Execute the ioscan -c tty 

-fn command to identify again the card instance, hardware path, and 
port number for the modem port. 

Step 6. Create device special files for the modem based on the card instance (or 
hardware path) and port number. You can use SAM to create the device 
special files (recommended) or usemksf. Modem device files have the 
following format: 


Device Special Files for Modems 


Access Mode ® 

Port Access 

Device File Format 

0 

Direct connect 

/dev/ cuainstanceppportf’ 

1 

Dial-out port‘d 

/dev/ culinstancefpport# 

2 

Dial-in modem‘s 

/dev/ttydinstancefpport# 


a. See mksf{\M) -a option of asioO and muxxdrivers. 

b. Instance number derives from ioscan -f output; use the card 
instance shown for the tty class of interface card to which the modem 
is being attached. 

c. Required for all modems. 


By default, mkfs creates a device special file for access mode 0 
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appropriate for terminals. To create a device file with modem syntax 
(that is, /dev/cua#p#), you need to execute mksf with the -i option. The 
-i is used for only direct connect; it is not necessary for dial-out or dial-in 
modem files. 


Here is an example of creating device special files with mksf for a Series 
700 whose modem is connected to hardware path 2/0/4. Notethat one 
file each is created for direct connect (-aO), dial-out modem (-ai) and 
dial-in modem (-a2). 

/usr/sbin/mksf -d asioO -H 2/0/4 -aO -i -v 

making cuaOpO c 1 0x000000 

/usr/sbin/mksf -d asioO -H 2/0/4 -al -v 

making culOpO c 1 0x000001 

/usr/sbin/mksf -d asioO -H 2/0/4 -a2 -v 

making ttydOpO c 1 0x000002 

Series 800 requires yet another additional option when creating device 
special files for a modem: you must cite the port number for the Series 
800 in your mksf command. (I n the following example, the card instance 
is used instead of the hardware path and the port is 2.) 

Step 7. Verify the creation of the device special files by using the issf command. 

For the Series 700 example, 

/usr/sbin/lssf /dev/cuaOpO 

asioO card instance 0 hardwired at address 2/0/4 /dev/cuaOpO 

/usr/sbin/lssf /dev/culOpO 

asioO card instance 0 callout at address 2/0/4 /dev/culOpO 

/usr/sbin/lssf /dev/ttydOpO 

asioO card instance 0 callin at address 2/0/4 /dev/culOpO 

For the Series 800 example, 

/usr/sbin/lssf /dev/cua0p2 

mux2 card instance 0 port 2 hardwired at address 56/0 /dev/cua0p2 

/usr/sbin/lssf /dev/cul0p2 

mux2 card instance 0 port 2 callout at address 56/0 /dev/cul0p2 

/usr/sbin/lssf /dev/ttyd0p2 

mux2 card instance 0 port 2 callin at address 56/0 /dev/cul0p2 

Step 8. With your modem still disconnected from the port, edit the 

/etc/inittab fileto add a getty entry for the modem port that will 
receive incoming calls. The entries must conform to the format 
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documented on the inittab (4) manpageof the HP-UX Reference For 
example: 

p5 : 234:respawn:/usr/sbin/getty -h -t 240 ttYd2p5 9600 

• The p5 is a label used to uniquely identify the entry. 

• This getty is executed when the system is i n both run states i and 2. 

• The respawn tells init to restart the process if it dies for any reason. 

• The /usr/sbin/getty is the process used to open the port and 
provide the initial login prompt. 

• The -h option ensures that the getty will set the port speed before 
resetting the port, which is crucial for the modem to work properly. 

• The-t 240 is a security option to requirethat the user login name 
and password is typed within 240 seconds. 

• The ttyd2p5 is the device for modem port through which the getty 
will receive incoming calls, (getty will complete the device name by 
prefixing /dev to the port designation.) 

• The 9600 does not represent the baud rate, but represents a label in 
the /etc/gettydefs file. See gettydefs (4). 

Step 9. After saving the file, invoke the following command to activate the 
updated /etc/inittab file: 

/sbin/init q 

Step 10. To verify that getty is running on the port in a pendi ng state, execute 
ps-ef I grep ttyd2p5 (using the device file name for which the getty 
was created). You should see a question mark in the tty field. 

Step 11. With modem still disconnected from the port, but powered on, the DTR 
or TR light should be off. Connect the modem to its port. DTR or TR light 
should come on. This verifies that the port (not the modem) is setting 
DTR or TR. If DTR or TR light remains on all the time, the modem has 
DTR strapped high and setting should be changed. Check the modem 
users' manual for procedure on how to change strapping. 

Step 12. Execute another ps -ef 

I grep ttyd2p5 command to verify that getty is still in a pending state. 
If getty has a port number in the tty field instead of a question mark, 
the modem has carrier detect (CD) strapped high. Check the modem 
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users' manual for procedure on how to change strapping. 

At this point the modem is ready for call-in use. 

Step 13. To set up the modem for cal l-out use, you must add entries to the 

/etc/uucp/Devices file. (This file does not have an associated manpage; 
follow the examples given in the file itself.) 

Edit /etc/uucp/Devices to include an entry for the /dev/cuiupp file 
created earlier. For example, 

ACU cul2p5 - 2400 hayes 
Direct cul2p5 - 2400 direct 

Step 14. After saving the file, you can test the modem's call-out ability executing 
the foil owing cu command: 

/usr/bin/cu -s2400 -Icul2p5 dir 

You should get a message indicating that you are connected. If you enter 
AT Return, the system will respond with ok. If it does not, the modem 
might have its echo turned off. Enter ATmteiephone_number and listen 
to the modem to hear if it dials. If the modem does not dial, refer to your 
modem user's manual or have the modem hardware checked out. 

The modem is now ready for call-out using cu -s2400 
telephone_number. 


Requirements for Modems to WDrk on HP-UX 

Your modem hardware documentation will be your primary resource for 
setting switch positions and commands for proper functioning of your 
modem. However, note the following information specific to HP-UX: 

• The modem should not ignore DTR, but instead autoanswer when H P 
computer raises DTR. Modem should hang up the line, disable 
autoanswer, and return to command state when computer drops DTR. 
(This is AT&D2 on Hayes modem protocol). Do not have the modem do 
power-on reset when DTR is dropped, as some modems temporarily 
raise CD during reset. (On Hayes modems, do not use at&d3.) 

• Modem should assert carrier detect only when there is a carrier and 
should drop CD when carrier is lost. (This is at&ci on Hayes modem). 

• Modemshould passthrough BREAK, becausetheBREAK keyisused 
for the interrupt signal as well as for baud-rate switching. 
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• Modem speed between modem and terminal should be known; 
however, speed can be negotiated in modem-to-modem connections 
(using the modems' autobauding speed detection). Initially, features 
such as hardware flow control (CTS/RTS) and error correct should be 
turned off. Once you have established that the modem communicates 
properly, add these features one at a time. 

• If modems connect but no data appears, turn off all compression, 
reliability, MNP, PEP, LAP, and other advanced features. Set the 
modem as simply as possible. Once working, add the advanced 
features. 

• Do not use CCITT control signals on modem or H P computer. Note 
that this does not affect the modem use of CCITT modulation or 
compression standards such as V.22, V.32, V.22bis, V.32bis, V34, V.42, 
or V.42bis. 

• Save modem settings i n non-volatile memory on modem so modem 
remembers setup after power loss. (UseAT&won Hayes modems). 

• Record modem settings on a worksheet in Appendix D , "Worksheets," 
for future reference. 
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Removing or Moving a Terminal or Modem 


NOTE Removing the system console is not supported. 


Terminals and modems are most easily removed using SAM, because 
SAM also removes the getty entries in /etc/inittab and ensures that 
inittab is reread. 

However, it is also a simple matter to remove a termi nal or modem using 
HP-UX commands. 

Step 1. I f users wi 11 be affected, notify them i n advance about the change. The 
terminal or modem to be removed cannot be in use; it must be inactive. 

Step 2. Create a backup copy of the /etc/inittab file by copying it. 

Step 3. Edit the /etc/inittab fileto remove or modify any getty entries for the 
terminal. Refer to inittab (4) in the H P-UX R^erence 

Step 4. Activate the updated /etc/inittab file by typing 

/sbin/init q 

Step 5. Update any software application configurations that use the moved 

terminal or modem. Refer to your software application documentation for 
specific instructions. 

Step 6. If you are removing the terminal or modem, unplug and disconnect it. 

I f you are movi ng the termi nal or modem, add the termi nal or modem to 
the system at the new hardware location, following the instructions 
found in "Configuring HP-UX for an HP Terminal or for a Modem", 
earlier in this chapter. 
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Troubleshooting Terminal Problems 

This section addresses problems with alphanumeric display terminals; 
however, the techniques can be applied to problems with terminal 
emulators such as AdvanceLink or X-Windows terminal processes (such 

as hpterm and xterm). 


Unresponsive Terminals 

Several conditions can cause a terminal not to display any characters 
except for those it echoes when you type. Proceed through these steps 
(working from an active terminal) to solve many of them. 

Step 1. Check the status of the system. If the system is still running, try 
resetti ng the termi nal. 

If the system is in single-user mode, the only active termi nal will be the 
system console; other terminals will not respond. Switch to a multi-user 
state. Consult the init (Im) manpage in the HP-UX Reference for 
information on changing run levels. 

Check your system run-level as follows: 

who -r 

run-level 2 Sep 28 10 07:10 2 0 S 

The current state of the machine (run-level 2 in this example) is shown 
in the highlighted field. For complete information on each of the fields, 
consult the who (1) manpage. 

Step 2. Look for an editor running on the terminal. Examine the active 
processes associ ated with the unresponsive termi nal and look for an 
editor (such as an active vi process). For example, for terminal ttyOpi, 

/etc/fuser /dev/ttyOpl 

or 

ps -t ttyOpl -f 

If you find an active editor process running at the termi nal, it is probably 
in a text-entry mode. You will need to save the work to a temporary file 
and exit the editor. If you are not sure of the status of the work being 
edited, do not simply save the file and exit. You will overwrite the 
previous contents of the file with unknown text. Save the 
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work-in-progress to a temporary file so that both the original and edited 
versions of the file are accessible. If all else fails, kill the editor process 
from the console, as described in step 8 .) 

Step 3. Enter Ctri-Q at the terminal keyboard. If output to the unresponsive 

terminal was stopped because an XOFF signal (Ctrl-S) was sent from the 
terminal to the computer, you can restart it by sending an XON signal 
(Ctrl-Q). 

If an application program is looping or functioning improperly, press the 
Break key and then Ctrl-C to attempt to regain a shell prompt. 

If the unresponsive terminal uses something other than Ctrl-C as the 
interrupt character, you can identify it by logging into another terminal 
and executing the command stty -a against the device special fileof the 
unresponsive terminal. Use the stty command only with device file 
names for currently active terminal device files. (Use who to see which 
device files are active.) Executing stty with an inactive device file will 
hang the terminal from which you enter the command. For example, 

stty -a < /dev/ttyOpl 

Compare the baud rate shown in the stty output and that set on the 
terminal. They should match. 

Step 4. Reset the terminal. On an FI P terminal, try a soft reset of Shift-Reset. 
If the terminal is stuck in an unusable state, power the terminal off, wait 
for a few seconds, and power it back on. This will reset the terminal, 
though the terminal owner's manual may have information on a better 
way to do it. You also might need to set the tabs with the tabs command. 

Step 5. On an HP terminal, use the menu keys to examine the modes 
configuration. 

• Is the terminal in Remote* mode? It should be 

• Is Block * mode turned ON? If so, turn it OFF 

• Is Line * mode turned ON? If so, turn it OFF 

• Is Modify * mode turned ON? If so, turn it OFF 

Step 6. Check the physical connection of the terminal toensurethat all 
cables arefirmly attached and properly located, all interface cards are 
firmly seated, the power cord is firmly connected, and the power switch 
is turned on. 
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Step 7. Send a short ASCII file to the unresponsive terminal's device file. 

Executethis in the background to retain the current terminal's 
responsiveness. For example, for an unresponsive terminal associated 
with the device file ttYdip4, 

cat /etc/motd > /dev/ttydlp4 & 

If you have solved the problem, you will see the contents of the file 
/etc/motd displayed on the terminal associated with /dev/ttydip4. 

Step 8. Kill processesassociated with the problem terminal. Before killing 
processes use extreme caution to be sure you are not killing a valid 
process that just happens to be taking a long time to complete.First 
examine the system's active processes, as shown. Then, to kill all 
processes associated with a specific tty device (for example, ttYd2p5), 
execute the kill command to force specified process I Ds (pid) to 
terminate. Execute the kill command in the foil owing sequence: kill 
-15, kill -3, kill - 1 , kill -9. (See signal (5) for definitions.) 


ps -ef 

UID PID PPID C STIME TTY TIME COMMAND 


root 94 I 
root I45I7 I 
jaz 20133 I 
root 22147 I 
jaz 21234 20133 
jaz 21235 21234 


0 Jul 20 ttyOpS 
0 Jul 21 ttYdlp4 
0 11:20:24 ttYd2p5 
0 13:33:45 ? 

0 12:22:05 ttYd2p5 
0 12:22:12 ttYd2p5 


0:00 /usr/sbin/get 
0:01 -csh [csh] 

0:00 -csh [csh] 
0:00 /etc/getty -h 
0:01 rlogin remote 
0:04 rlogin remote 


Y -h tty0p5 9600 

ttydipO 9600 


kill -15 21235 21234 20133 

Once the prcxesses termi nate, init restarts a new petty prcxess for that 
terminal (provided its /etc/inittab entry contains respawn). 

Step 9. Check the parameters of the unresponsive terminal's device file. 

Like all files, device special files have access permissions that must be 
set to allow you access. For example, permissions set to 622 (crwww-) are 
appropriate for a terminal. Makecertain the file is a character device 
file. 

Step 10. Make sure your inittab entries are active. To force init to update 
its initialization tables from /etc/inittab, execute the command init 
q- 

Step 11. Make sure the /dev/muxn and /dev/tty files are present. The 

/dev/muxn is the device file associated with the interface card. The 
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/dev/tty is a pseudo-device used in many places to refer to the login 
terminal. 

Step 12. Check the functionality of your hardware. 

a. If the unresponsive terminal has a self-test feature, activate it. If not, 
power the terminal off, wait several seconds, and power the terminal 
back on. 

b. Swap the unresponsive terminal with one known to be functioning. 
Swap only the terminal and keyboard. Attach the properly 
functioning terminal to the same cable the unresponsive terminal 
used. Plug the unresponsive terminal and keyboard to the same cable 
used by the properly functioning terminal and see if it works there. 

If the properly functioning terminal does not work on the 
unresponsive terminal's cable and the unresponsive terminal works 
at the new location, the unresponsive terminal is not the problem. 

c. Check the cable connecting the unresponsive terminal to the 
computer. Swap the suspect cable with a known good one. If this 
solves the problem, the cable is bad or is not wired correctly. If this 
does not solve the problem, your MUX, port, or interface card might 
be malfunctioning. 

d. On Series 800 multiplexers, problems occur when 

• /dev/mux/: is deleted or has inappropriate permissions. 

• the download firmware is deleted or has inappropriate 
permissions. 

• /sbin/dasetup is not run from /etc/inittab. dasetup should 
only be run from inittab. Do not run it in any state other than 
single-user mode. 

Garbage Displayed on the Terminal Screen 

If garbage is mixed with valid data, the problem might be: 

• Noise on the data Iine, because 

— RS-232-C cable is too long (maximum recommended length is 50 
feet or 15 meters at 9600 baud). 

— data cable is situated near electrically noisy equipment, such as 
motors. 
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— wires are partially shorted or broken within the cable. 

— telephone connection is noisy 

• Parity is incorrectly set. (See "Differences between Console and 
Terminal Configuration".) 

• Hardware problem with a modem, i nterface card, or the terminal 
itself 

• The program performing I/O might be sending the garbage 

• The Display Functns* feature of your terminal is enabled (which 
displays characters that would not normally print) 

• You might be displaying a non-ASCII file. 

If everything printed is garbage, examinethese possible causes: 

• Baud-rate mismatch (most likely) If your terminal's speed setting 
differs from that read by the stty command, garbage will appear on 
your screen. 

I f you have not yet logged in, press the Break key, fol lowed by Return, 
Return, to force getty to try the next entry in /etc/gettydefs. 
Typically, thegettydefs file is set up so that each time you press the 
Break key, getty tries the next speed setting, as defined in 
/etc/gettydefs. When getty matches the speed set to your 
terminal, you will get a readable login prompt. 

• Parity generation/checking mismatch. Use stty to determine the 
proper setti ngs for the termi nal. 

• The TERM environment variable is incorrectly set. Ifyou have an HP 
terminal, try setting the term value to hp using your shell's set 
command. 

• A running process is producing garbage output. 

• The cable might be miswired or the data line might be noisy. 

• You might have a hardware failure in your interface card, modem, 

MUX or other device. 

The TERM environment variable is required for software compatibility 
with the termi nal. At the ti me of login, H P-U X software reads the 
terminfo setting. If you have changed the configuration during a 
terminal session, you need to alert the software to the change by 
exporting the term variable. For example, in Korn shell, export 
TERM=vtlOO 
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Refer totheterminfo (4) manpagefor further explanation. 
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For Further Information on Terminals and 
Modems 

The following manpages specify terminal- and modem-related 
functionality: 


mesg (1) 

Permit or deny messages to a terminal 

pg(i) 

stty (1) 

tabs (1) 

File paginator for video terminals 

Set options for a terminal port 

Set tabs on a termi nal 

telnet (1) 

User interface to the telnet protocol 

tput(1) 

tset (1) 

Generate termi nal-specific functions 

Terminal-dependent initialization 

tsm (1) 

Terminal Session Manager 

tty(l) 

ttytype(l) 

captoinfo (IM) 

Get the name of the termi nal or pseudo-terminal 

Terminal identification program 

Convert a termcap description into a terminfo 
description 

dpp(lM) 

getty (IM) 

mksf (IM) 

Dedicated port parser, used by DDFA software 

Set terminal type, modes, speed, line discipline 

Make special files 

riogind (IM) 

tic(lM) 

Remote login server 

terminal escape sequence (terminfo) compiler 

untie (IM) 

terminal escape sequence (terminfo) extractor 

uugetty (IM) 

gettydd's (4) 

tarn (4) 

Set terminal type, modes, speed, line discipline 

Speed and terminal settings used by getty 

Format of compiled terminal file 

term! nfo (4) 

Terminal capability database 

ttytype (4) 

Database of terminal types by port 
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environ (5) 
modem (7) 
pty (7) 


User environment variables 
Asynchronous serial modem line control 
Pseudo-terminal driver 
General terminal interface 
Controlling terminal interface 


tamio (7) 
tty (7) 


The following manuals provide additional information: 

• Terminal Control User's Guide 

• Using Serial Connections Technical Guide 

• Terminal Session Manager User's Guide 

• DTC DeviceFileAccess Utilitiesand Telnet Port Identification 
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Configuring Disk Drives, Disk 
Arrays, and CD-ROM Drives 


This chapter gives procedures and guideiines for configuring hard and 
floppy disk drives and disk arrays to SCSi interfaces. Procedures and 
guidelines are also provided for configuring CD-ROM drives to SCSI 
i nterfaces. 

When configuring a disk drive, disk array, or CD-ROM drive, have 
avail able the foil owing additional documentation: 

• M anagi ng Systems and Workgroups 

• H P-UX Reference 

• Pertinent hardware documentation for the computer, device adapter, 
and peripheral device 

• Record of your disk configuration 


You can use /usr/sbin/ioscan -c disk to identify disks configured on 
your system. You can use /usr/sbin/diskinfo to find out disk 
characteristics. Once you have configured a disk and are creating a file 
system, HP-UX uses the correct disk geometry, without requiring you to 
cite an explicit /etc/disktab entry. For backward compatibility, you can 
still consult /etc/disktab for disk geometry information on older disks. 
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Planning to Configure a Disk Drive 

Review the material discussed in this chapter for each kind of disk drive. 

Identify the device driver(s) that must be present in the kernel for the 
interface and disk device you are installing. You will find the device 
drivers listed in "Selecting Device Drivers for a Disk Device and 
I nterface". 

Once you have planned your disk configuration, proceed to the section, 
"Configuring HP-UX for a New Disk Device". 

Performance 

Overall system performance depends partly on how your disks are 
arranged on your system. 

Tooptimize performance, consider the distribution of data on your disks. 
If possible, use several smaller disks instead of a single larger-capacity 
disk for all disk needs. Configure a mid-sized disk (for example, 677MB 
or 1GB) for / and /usr filesystems and for any software applications. 
Use separate disks for user files, database files, and anything else that 
grows. This allows the system to perform more efficiently by distributing 
I/O across spindles and shortens thetimefor file-system integrity check. 

Do not exceed H P-recommended guidelines for maximum number of 
disks or disk arrays per interface card. Note too that the kind of disk 
access (random vs. sequential), CPU overhead and total system capacity, 
cabling distance, disk-array configuration, and block size all affect 
performance. 

Consult your HP sales representative for information on performance 
expectations, based on your predominant system I/O workload and disk 
characteristics. 

Considerations for Configuring a Disk Array 

You must use SAM to configure and manage the H P A3231A and A3232A 
disk arrays. The configuration utilities for these devices are unavailable 
usi ng a command-1 i ne i nterface. 

If you areconfiguring any other disk arrays, be sure that you have loaded 
onto your system the c2400-util fileset containing the disk array 
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configuration tools. 

Consult the hardware documentation to find out what degree of data 
protection is provided by the RAID level in which the disk array is 
shipped. If you need to modify the RAI D level, use the disk array utilities 
provided. 

If you are configuring a disk array with more than one controller, you 
wi 11 be usi ng more than one target address. Be sure you choose a SCSI 
interface with sufficient bus addresses available. 

Do not attempt to use disk space larger than 4GB without apportioning 
the space with LVM. HP-UX cannot address disk space in excess of 4GB; 
any remaining disk space would be unusable. Given this maximum-size 
limitation, hard partitions will work. Similarly, boot, dump, or primary 
swap cannot be greater than 2GB. 

You can use Logical Volume Manager (LVM) to partition disk arrays into 
logical volumes, manage mirrored filesystems, and deal with file 
systems on disk arrays in independent mode. See Managing Systems and 
Workgroups for documentation on configuring and managing file systems 
on LVM. 

Take care to terminate all busses. Keep cabling (including internal SCSI 
cabling) to within recommended bounds. 

Considerations for Configuring a CD-ROM Drive 

CD-ROM drives are configured like a standard disk using SAM or 
command-line interface, but because CD-ROMs hold read-only file 
systems, 

• You cannot use a CD-ROM for swap space. 

• Users cannot create a new filesystem on a CD-ROM disk. 

Considerations for Configuring a Floppy Disk Drive 

Floppy disk drives are installed as internal devices on some HP-UX 
systems. You might need to configure the device drivers i nto the system 
for H P-UX to be able to communicate with the media. (See floppy (7) in 
the HP-UX Reference and "Floppy Disk Drive Configuration Guidelines" 
later in this chapter for device driver information.) 

• Floppy disks are not supported as boot disks. 
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• If using SAM, choose the action, Add ->Not Using LVM. LVM 
functionality is not supported on floppy disks. 

• Uni ike HP harddisks, which are typically initialized before shipping, 
you must initialize floppy-disk media, using the mediainit 
command. See mediainit (IM) in the H P-UX Rd'erencefor 
information. 

• Do not use low-density floppy disks. Supported disk formats vary by 
system model and are documented on the floppy (7) manpage. 

• Floppy drives are supported on H P-UX primarily for transferring raw 
data. Thus, commands such as tar can be used effectively with floppy 
disks. You must know in what format your media is written. 

• I n some respects, using a floppy disk drive on an HP-UX system 
differs significantly from using a floppy disk drive on a personal 
computer: 

— Unlike personal-computer floppies, you can make a file system on 
an HP-UX floppy disk. Use newfs to createthefilesystem. 
Consult /etc/disktab to choose an entry (for example, ibmi440) 
appropriate for the capacity of the floppy disk. 

To access a file system on a floppy disk, you must mount it first. 

— Media removal and replacement while the device is open is not 
supported. A floppy disk containing a mounted filesystem must 
not be removed prior to being unmounted. Removal of floppy disks 
whilethe device is open is likely to result in filesystem errors and 
system crashes. 

— If an application requires that you insert and remove media while 
the program is running, the floppy disk should work properly. 
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Selecting Device Drivers for a Disk Device 
and I nterface 

The following sections (covering SCSI interfaces and floppy disk drives) 
identify the device drivers that must be present in the kernel for HP-UX 
to communicate with your disk device. Choose the device drivers based 
on the interface to which you are configuring the disk device. 

If you are configuring a custom-written device driver on a Series 700, 
consult the Driver Development Guide for guidelines. 

Once you have identified your device drivers, proceed to "Configuring 
HP-UX for a New Disk Device". 

SCSI Disk Configuration Guidelines 

The SCSI address of a device dictates the device's priority when 
arbitrating for the SCSI bus. Use SCSI address 7 for the highest priority 
device (usually the host), followed by subsequent addresses in 
descending order: 6, 5, 4, 3, 2,1, 0, 15,14,13, 12, 11,10, 9, 8. 

Each fast/wid^differential SCSI -I I card can support up to 15 
peripherals, including up to 7 disk arrays. Due to limitations in SCSI-11, 
disk arrays can be connected to addresses 0 through 7 only; do not 
connect disk arrays to addresses 8 through 15. 

HP-UX recommends UPS for powerfail protection of 
fast/wide/differential disk arrays. 

Do not exceed 6 meters maximum cabling for single-ended SCSI and 25 
meters maximum for fast/wide/differential SCSI configurations. 

Make sure that every SCSI bus is properly terminated. 

Table 4-1, "SCSI-I I Disk Configuration Requirements," lists the H P disk 
and CD-ROM devices configurable through the SCSI interface on Series 
700 and 800 systems. 

Note, the c#t#d# [s#] syntax used in default device special files derives 
from ioscan output: c# is the card instance for the ext_bus class of 
interface card to which the device is attached, t# isthe target (SCSI 
address) of the disk device on the interface, d# is the device unit number, 
s# specifies section number and is provided for backward compatibility; 
the device file addresses the entire disk (sO) when s# is unspecified. (See 
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the disk (7) manpage.) 

SCSI-II Disk Configuration Requirements 


Architecture 
(SCSI-II Type) 

Interface 

Card 

Interface 
and Device 
Drivers 

Default Device File 

Series 700 Core 

I/O 

(Single-Ended)® 

(internal) 

sdisk*’ 

/dev/[r]disk/c#t# 
d#[s#] 

Series 700 EISA 

25525B 

eisa 

(same as above) 

(Eas t/N arrow/Diff 
erential)‘^ 


sdisk*’ 


Series 700 Models 
735, 755‘^ 

(internal) 

sdisk*’ 

(same as above) 

(East/Wide/Differ 

ential) 




Series 800 CIO 

27147A 

scsi2 

(same as above) 

Single-Ended)® 


disc3® 


Series 800 HP-PB 

28655A 

scsil 

(same as above) 

Single-Ended)*’ 


disc3® 


Series 800 HP-PB 

25525B 

scsi3 

(same as above) 

(East/Wide/Differ 
ential) ’ 


disc3® 



a. The following disk devices can be configured to a Series 700 
Single-Ended SCSI-II interface; (AI999A), (A2655A), 2657A, 
C22I4B, C22I6T, C22I7C, (C229IA), C2293A/T/U, C2295B, 
C2473T, C2963A, C2964A, C3020T, C302IT, C3023T, C3024T, 
C3027TU, C3028U, A3I82A. (Models shown in parenthesis are 
obsolete and are listed for reference only.) 

b. Specifying sdisk causes sctl, c700, and c720 to be included 
automatically in the kernel. 
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c. The following disk devices can be configured to a Series 700 
Fast/Narrow/Differential EISA/SCSI-II: (C2425JK), (C2427JK), 
C2435A, (C2436HA), C2436HZ, C2438A, (C2439HA), 
C2439HZ/JA/JZ, (C2440HA), C2440HZ/JA/JZ, C2474J, (C2481A), 
(C2482A), (C2491 A), (C2492A). (Models shown in parenthesis are 
obsolete and are listed for reference only.) 

d. The following disk devices can be configured to a Series 700 Fast/ 
Wide/Differential SCSI-II interface: C2435A, (C2436HA), C2436HZ, 
C2437HA/HZ, C2438A, (C2439HA), C2439HZ/JA/JZ, (C2440HA), 
C2440HZ/JA/JZ, C3032T, C3033T, C3034T, C3035T, C3036T, 
C3037U, C3038U, A3058A. The (C2425JK) and (C2427JK) can also 
be connected, but will not use the Wide SCSI capability. (Models 
shown in parenthesis are obsolete and are listed for reference only.) 

e. The following disk devices can be configured to a Series 800 CIO 
Single-Ended SCSI-II interface: C2462E/R, C2474E/R/S, C2476E/R, 
A3182 A. 

f. Specifying scs 12 causes cio_caO to be included automatically in 
the kernel. 

g. Specifying disc3 causes target to be included automatically in 
the kernel. 

h. The following disk devices can be configured to a Series 800 HP-PB 
Single-Ended SCSI-II interface: (7957B), (7958B), (7959B), 

(A 1999A), (A2655A), C22I2A, (C22I3A), C228IA, C2282A, 
(C2290A), (C229IA), C2460E/R, C246IE/R, (C2470S), (C247IS), 
C2472E/R/S, C2473E/R/S, C3020T, C3022R/T, C3023R/RZ/T, 
C3024R/RZ/T, C3027U, C3028U, C3040R/T, C304IR/T, C3044U, 
A3182 A, C3560U. (Models shown in parenthesis are obsolete and are 
listed for reference only.) 

i. The following disk devices can be configured to a Series 800 East/ 
Wide/Differential SCSI-II interface: C2435A, C2436HA/HZ, 
C2437HA/HZ, C2438A, C2439HA/HZ/JA/JC, C2440HA/HZ/JA/JZ, 
C3032R/T, C3035R/T, C3036T, C3037U, C3050R/T, C305IR/T, 
A305IA, A323IA, A3232A, C3550R/T, C355IR/T, C3553RZ, 
C3554U. 


Floppy Disk Drive Configuration Guidelines 

Although floppy disk drives are installed internally, the following table is 
included to ensure that you have the device-driver information necessary 
to access the drive. 

Notethat a PC floppy is installed on a Model 712 system, while SCSI 
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floppy disk drives are installed on some Series 700 and E-class (Series 
800) computers. 

(See also "Considerations for Configuring a Floppy Disk Drive"for 
information about using a floppy disk drive with H P-UX.) 

Floppy Disk Drive Configuration Requirements 


Architecture 

Interface 

Card 

Interface and 
Device 

Drivers 

Default Device File 

Model 712 

(internal) 

pcfdc 
pcfloppy 

/dev/ [r] floppy/ 

c#t#d#^ 

Series 700 
Single-Ended 

SCSI 

(internal) 

sflop 

(same as above) 

Model E 
Single-Ended 

SCSI 

(internal) 

disc3 

(same as above) 


a. c#t#d# derives from ioscan output: c# is the card instance for the 
ext_bus class of interface card to which the device is attached, t# is 
the target (SCSI address) of the disk device on the interface, d# is the 
device unit number. See disk (7). 

b. Specifying disc3 causes target to be included automatically in the 
kernel. 
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NOTE 


Configuring HP-UX for a New Disk Device 

The si mplest way to configure a disk device (hard disk, floppy disk, disk 
array, or CD-ROM) is to use SAM (/usr/sbin/sam). If SAM is not loaded 
on your system or if you prefer to use the command-1 i ne i nterface, the 
following procedure will guide you through the task. Familiarize yourself 
with the instructions before getting started. 

Step 1. I nvoke /usr/sbin/ioscan 

-fn to figure out what addresses are available on the interface card to 
which you will be attaching the disk. 

For examples of ioscan usage, consult "Using ioscan to Display your I/O 
Configuration," in Appendix B of this book. 

Step 2. Consult the tables in the previous section ( "Selecting Device Drivers for 
a Disk Device and Interface") to determine the device driver(s) needed 
for your disk and interface. (If you are configuring a magneto-optical 
device, use the table in the section, Magneto-Optical Disk Configuration 
Guidelines, found in the next chapter.) If any necessary static driver is 
absent from the kernel, you will need to rebuild the kernel to include it. 
Here is how to rebuild the kernel: 

Step 3. Change directory to the build environment (/stand/build). There, 

execute a system preparation script, system_prep, which extracts the 
system file from the current kernel, as fol lows: 

cd /stand/build 

/usr/lbin/sysadm/system_prep -v -s system 

The system_prep script writes a system file in your current directory 
(that is, it creates /stand/buiid/system). The -V gives verbose 
explanation as the script executes. 

Step 4. Modify the /stand/buiid/system file to add the absent driver(s) by 

invoking the kmsystem command. The -c y specifies that driver-name is 
to be configured i nto the system. 

/usr/sbin/kmsystem -S /stand/buiid/system -c Y driver-name 


To avoid introducing format errors, do not edit the HP-UX system 
description files directly. Instead, use the commands kmsystem and 
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kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


Step 5. Build the new kernel by invoking the mk_kernei command. This creates 

/stand/buiid/vinunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

Step 6. Save the old system file by moving it. Then move the new system file into 
pi ace. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

Step 7. Prepare for rebooting by invoking the kmupdate command. This sets a 
flag that tel Is the system to use the new kernel when it restarts. 

/usr/sbin/kmupdate 

Step 8. Notify users that the system will be shut down to configure the disk. You 
can use the wall command and/or the interactive capabilities of the 
shutdown command to broadcast a message to users before the system 
goes down. See wall (IM) or shutdown (IM) in the H P-UX Reference 

Step 9. Bring the system down to a halt, using the shutdown command. 

Step 10. Turn off the power to all peripheral devices and then totheSPU. 

Step 11. Install the hardware, following instructions provided in the hardware 

documentation. When attaching the disk, set the switches on the disk to 
an unused target address, which you will have determined from loscan 
output. Use the cabling recommended in the hardware documentation. If 
installing a SCSI device make sure the last device in the SCSI chain is 
terminated. 

Step 12. Turn on the power to all peripheral devices. Wait for them to become 
"ready", then turn on power totheSPU. 

On booting up, H P-UX detects the new disk and associates it with its 
device driver. 

Also during boot-up, insf creates the character and block device special 
(/dev) files required to communicate with the disk. For a disk array in 
independent mode, insf creates device special files for each disk; in 
striped mode, insf treats the entire array as a single disk. 
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Step 13. Verify the configuration by executing ioscan. If you are configuring a 
harddisk, you have finished the initial configuration. 

If you are configuring a floppy disk drive, initialize the floppy disk by 
invoking the mediainit command on the character device special file. 
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Planning to Configure into your System a 
Disk Already Containing Data 

When configuring a new disk onto either Series 700 or 800 system, both 
SAM and insf now treat the disk in its enti rety and create a single block 
device special file in /dev/dsk and a single character device special file 
in /dev/rdsk. As of H P-UX 10.0, to apportion disk space on both Series 
700 and 800 systems, use Logical Volume Manager (LVM), which is 
documented in the Managing Systems and Workgroups manual. 

Configuring a disk already containing data into HP-UX 10.0 requires 
some attention to detail, because the I/O system is largely converged and 
the HP-UX file system layout (that is, the locations of system files and 
directories) has changed. 

Approach the task in two stages: 

1. Examine the files and data on the disk for possible clashes with the 
HP-UX 10.0, and take the necessary precautions, as documented in 
"Ensuring Against Clashes with HP-UX 10.0", the next section. 

2. Configure the disk into HP 10.0. 

Once 9.x Series 700 whole disks and Series 800 disks with hard 
partitions are successfully configured, HP-UX 10.0 accesses their data 
using a compatibility pseudo-driver (cpd). 

Ensuring Against Clashes with HP-UX 10.0 

Before you configure a disk containing 9.x data to a 10.0 system, it is 
essential that you make sure you will not be introducing file-system 
inconsistencies. This precaution is necessary because the file-system 
layout has changed dramatically from H P-UX 9.xto 10.0. Former system 
files and device files will not work in the new operating system and 
might cause serious problems if they are used. 

The new file-system hierarchy is based on AT&T V.4 and OSF/1. The 
organization of files and directories are explained in a white paper 
entitled H P-UX 10.0 File System Layout. 

To ensure against incompatibilities with HP-UX 10.0: 

Step 1. Examine the files on the 9.x disk to make absolutely sure you do not 


114 


Chapter 4 





Configuring Disk Drives, Disk Arrays, and CD-ROM Drives 

Planning to Configure into your System a Disk Already Containing 

Data 

mount system directories and structural files. System directories include 
/usr, /dev, /etc, /system, /bin, and /lib. Structural files include files 
such as /etc/checklist and dfile. Never attempt to use 9.xdevice 
special files on a 10.x system. They will fail. Delete or rename any 
system files and directories you find. 

Step 2. Examine user scripts for occurrences of 9.x-specific path names and 

commands that are invalid or obsolete for 10.0. Do this bd'ore mounting 
the 9.x disk. 

HP has some tools on 10.0 to help identify and correct changed or 
unsupported path names. These tools are shipped in the following 
filesets: 

• Upgrade.UPG-ANALYSIS 

• Upgrade.UPG-MAN 

On a 10.0 system, the tools are installed in the /opt/upgrade/bin 
directory. The manpages are installed in /opt/upgrade/share/man. If 
you have obtained the filesets to beloaded onto an 9.x system, the 
filesets will be installed into /upgrade/bin and /usr/man. 

Consult the manual. Moving HP-UX 9.x Code and Scripts to 10.x: Using 
theAnalysis and Conversion Tools and the upgrade manpages for further 
guidance on preparing 9.x files for HP-UX 10.0. 

Understanding How to Configure a Disk Already 
Containing Data 

Accessing 9.x data might require that you configure one of the foil owing 
9.xdisk types to HP-UX 10.0: 

• Series 700 disks using Software Disk Striping (SDS). SDS is not 
supported on H P-UX 10.0. The safest way to import 9.x data from an 
SDS disk is as follows: 

Step 1. Isolate the specific files of data. 

Step 2. Examine the files for presence of system and structural files (as 

documented in the previous section) and remove any invalid references. 

Step 3. Copy the i nformation onto a 10.0-configured disk. 

• Series 700 whole disks. 
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Step 1. Examine all files for the presence of system and structural files (as 

documented in the previous section) and remove any invalid references. 

Step 2. Configure the disk as documented in "Configuring into your System an 
Unpartitioned Disk Already Containing Data", shortly, insf creates the 
required device special files to access the whole disks. If the disk is used 
in its entirety (as it was on 9.x), the data will be accessed using the cpd. 

• Series 800 disks with hard partitions/sections. 

Step 1. Examine all files for the presence of system and structural files (as 

documented in the previous section) and remove any invalid references. 

Step 2. Configure the disks with Series 800 hard partitions by following the 
procedure "Configuring into Your System a Partitioned Disk Already 
Containing Data", later in this chapter. You will create device special 
files for each section using mksf or mknod. The cpd will enable you to 
access the partitioned data. 

• Series 800 LVM disks. 

Step 1. Examine all files for the presence of system and structural files (as 

documented in the previous section) and remove any invalid references. 

Step 2. Add Series 800 LVM disks to a 10.0 system by importing the LVM 

information, as documented in "Configuring into your System an LVM 
Disk Already Containing Data". 
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Containing Data 


Configuring into your System an 
Unpartitioned Disk Already Containing Data 


NOTE This procedure is provided for configuring a Series 700 iegacy disk into 

HP-UX 10.0. Before proceeding, make sure you have read "Pianningto 
Configure into your System a Disk Aiready Containing Data" and have 
performed the examination documented in "Ensuring Against Ciashes 
with HP-UX 10.0". 


Step 1. Back up the data on the disk being configured into the system; seethe 
backup chapter in Managing Systems and Workgroups. 

Step 2. Create a record of the system's current disk configuration for iater use: 

/usr/sbin/ioscan -fun -C disk 

Note whether the current configuration inciudes the device driver 
needed to communicate with the disk you intend to configure. Consuit 
"Seiecting Device Drivers for a Disk Device and i nterface" for guideiines 
on compatibie disks, device drivers, and interfaces. 

if any necessary device driver is absent from the kernei, you wiii need to 
rebuiid the kernei to inciude it. Here is how you rebuiid the kernei: 

a. Change directory to the buiid environment (/stand/build). Execute 
a system preparation script, system_prep, which extracts the system 
fiiefrom the current kernei and writes a system fiie in your current 
directory. (That is, it creates /stand/buiid/system.) The -v gives 
verbose expianation as the script executes. 

cd /stand/build 

/usr/lbin/sysadm/system_prep -v -s system 

b. Modify the/stand/build/system fiieto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 
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description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the H P-UX Reference 


c. Build the new kernel by invoking the mk_kernei command. This 
creates /stand/buiid/vmunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Preparefor rebootingby invoking the kmupdate command. This sets a 
flag that tells the system to use the new kernel when it restarts. 

/usr/sbin/kmupdate 

Step 3. Bring the system down and physically install the disk device. 

Step 4. Turn on the power to all peripheral devices. Wait for them to become 
"ready", then turn on power to the SPU. On booting up, H P-UX detects 
the new disk and associates it with its device driver, insf creates the 
character and block device special (/dev) files required to communicate 
with the disk. 

steps. Execute /usr/sbin/ioscan 

-fun -c disk again, to identify the newly configured disk device and its 
device special files. 
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Configuring into Your System a Partitioned 
Disk Already Containing Data 


NOTE This procedure is provided for configuring a Series 800 iegacy 

hard-partitioned disk into HP-UX 10.0. Before proceeding, make sure 
you have read "Pianning to Configure into your System a Disk Aiready 
Containing Data" and have performed the examination documented in 
"Ensuring Against Ciashes with HP-UX 10.0". 


Step 1. Before you move a di sk from one system to another, you must create a 
dear record of how the disk is set up on its originai system. Make a 
record of the foiiowing output: 

• bdf, for information on what fiie systems are mounted. 

• /etc/fstab, for information about the fiie systems mounted on the 
disk at boot time, (if the disk is being moved from a 9.x system, the 
equivaient fiie wiii have been caiied /etc/checkiist. if the disk 
being moved is partitioned, /etc/checklist wiii be your oniy source 
of information for what partitions (sections) are being used.) 

• swapinfo, for information on device and fiie-system swap space 
enabied on the disk. 

• i f the disk is used for a database, make a record of the database 
configuration fiie. 

Step 2. Back up the data on the disk; seethe backup chapter in Managing 
Systems and Workgroups. 

Step 3. Create a record of your system's current disk configuration for iater 
comparison: 

/usr/sbin/ioscan -fun -C disk 

Step 4. Note whether the current configuration inciudes the device driver(s) 
needed to communicate with the disk you intend to configure. Consuit 
thetabies in "Seiecting Device Drivers for a Disk Device and interface" 
for guideiineson compatibie disks, device drivers, and interfaces, if any 
necessary device driver is absent from the kernei, you wiii need to 
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rebuild the kernel to include it. Here is how you rebuild the kernel: 

a. Change directory to the build environment (/stand/build). There, 
execute a system preparation script, system_prep. sYstem_prep 
writes a system file based on your current kernel in the current 
directory. (That is, it creates /stand/buiid/system.)The-v provides 
verbose explanation as the script executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

b. Modify the/stand/build/system fileto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 

description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


c. Build the new kernel by invoking the mk_kernei command. This 
creates /stand/buiid/vmunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Preparefor rebootingby I nvoki ng the kmupdate command. This sets a 
flag that tells the system to use the new kernel when it restarts. 

/usr/sbin/kmupdate 

Step 5. Bring the system down and physically install the disk device. 

Step 6. Turn on the power to all peripheral devices. Wait for them to become 
"ready", then turn on power totheSPU. 

On booting up, H P-UX detects the new disk and associates it with its 
device driver, insf creates a single character device special file and a 
single block device special file to communicate with the entire disk. 
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Step 7. Execute /usr/sbin/ioscan -fun 

-c disk again, to verify that the disk device configured successfully and 
to identify its whole-disk device special files (/dev/ [r] dsk/c#t#d#). 

Step 8. Usethemksf command to create device special files for each individual 
section being used on the disk. (Refer to the printout of /etc/checkiist 
to identify the sections.) 

Note, as of H P-UX 10.0, sections 2 and 0 have been switched: sO now 
specifies whole disk; s 2 specifies the portion of the disk that was 
previously represented by sO. Also, since sections are only minimally 
supported at 10.0, consult earlier documentation or version of 
/etc/disktab for disk sectioning geometry. 

For example, 

/sbin/mksf -C disk [ -H hardware_path -I Instance ] -s 
section_number 

/sbin/mksf -C disk [ -H hardware_path -I Instance ] -r -s 
section_number 

Step 9. Execute /usr/sbin/ioscan -fun 

-H hardware_path to verify that the device special files were created 
successfully. 
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Configuring into your System an LVM Disk 
Already Containing Data 


NOTE This procedure is provided for configuring a Series 800 iegacy LVM disk 

into HP-UX 10.0. Before proceeding, makesureyou have read "Pianning 
to Configure into your System a Disk Aiready Containing Data" and 
have performed the examination documented in "Ensuring Against 
Ciashes with HP-UX 10.0". 


Step 1. Back up the data on the disk; seethe backup chapter in Managing 
Systems and Workgroups. 

Step 2. Unmount any fiiesystems residing on the LVM disk by using the umount 
command. 

Step 3. Deactivate the disk's voiume group by usingthe vgchange command. 

Step 4. Remove the voiume group of the disk from its current configuration and 
prepare to export it usi ng the vgexport command. The -m option creates 
a mapfiie that retains the names of the iogicai voiumes in the voiume 
group. 

/usr/sbin/umount /dev/vgOl/lvoll 
/usr/sbin/vgchange -a n /dev/vgOl 
/usr/sbin/vgexport -m mapfiie /dev/vgOl 

steps. Copy the mapfiie to the new system on which the disk wiii reside. On a 
networked system, you can use rep or ftp. 

Step 6. Create a record of your system's current disk configuration for iater use. 

/usr/sbin/ioscan -fun -C disk 

Step 7. Note whether the current configuration inciudes the device driver 

needed to communicate with the disk being configured, if any necessary 
driver is absent from the kernei, you wiii need to rebuiid the kernei to 
inciude it. Here is how you rebuiid the kernei: 

a. Change directory to the buiid environment (/stand/build). There, 
execute a system preparation script, system_prep, which extracts the 


122 


Chapter 4 







Configuring Disk Drives, Disk Arrays, and CD-ROM Drives 

Configuring into your System an LVM Disk Aiready Containing Data 


system file from the cur rent kernel and writes a system file in your 
current directory. (That is, it creates /stand/buiid/system.) The -v 
gives verbose explanation as the script executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

b. Modify the /stand/build/system fileto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 

description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


c. Build the new kernel by invoking the mk_kernei command. This 
creates /stand/buiid/vmunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Preparefor rebootingby invoking the kmupdate command. This sets a 
flag that tells the system to use the new kernel when it restarts. 

/usr/sbin/kmupdate 

Step 8. Bring the system down and physically install the disk device. 

Step 9. Turn on the power to all peripheral devices. Wait for them to become 
"ready", then turn on power totheSPU. 

Step 10. Watch the bootup sequence and record the name of the block device 
special file created for the new LVM disk. 

You can also identify the disk device by using the ioscan command. 

/usr/sbin/ioscan 

-fn -c disk will display all disks and their device special files. Or, you 

can use /usr/sbin/ioscan -H hardware_path-fn tO identify the disk 
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device by location. 

Step 11. Scan your current system to identify all disks by their volume groups. 

/usr/sbin/vgscan -v 

Step 12. Create a directory for the volume group to which the new LVM disk will 
belong. For example, a new volume group might be called vg06. 

mkdir /dev/vg06 

Step 13. Check to make sure that you are creating a unique minor number for the 
new group file. Then create a character device special file for the new 
volume group's group file. The character major number for LVM is 64. In 
the minor number, n must be in the range between o and 9, because the 
maximum number of volume groups by default allowed on a system is 
ten. You can increase the number by changing the operating-system 
parameter maxvgs in /usr/conf/master.d/core-hpux or by using 
SAM. 

11 /dev/*/group 

mknod /dev/vgO6/group c 64 OxOnOOOO 

Step 14. I mport the LVM disk to the current system, citing the the block device 
special file name you noted when the system booted up and themapfiie 
you created when invoking vgexport at the beginning of the procedure. 
You can preview the effect of the import by using the -p option. 

vgimport -pv -m mapfile /dev/vg06 block_dev±ce_spec±al_file 
vgimport -v -m mapfile /dev/vg06 block_device_special_f±le 

The vgimport command adds the volume group name to the 
/etc/ivmtabfile. 11 also adds the device special files associated with the 
volume group's logical volumes to the system. 

Step 15. Activate the new volume group. 

/usr/sbin/vgchange -a y /dev/vg06 

Step 16. Mount the logical volumes to their new mount point. For further 
information on mounting and unmounting, consult the Managing 
Systems and Workgroups manual. 

mkdir /new_location 

mount /dev/vg06/lvoll /new_location 
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Moving a Disk Drive to a Different Address 

Occasionally, you might find yourself having to move a disk from one 
interface card to another. This procedure explains how to do so. 


NOTE Moving the root disk and moving an LVM root disk are special cases. You 

will find additional instructions at several points in this procedure to 
cover these requirements. 


To move a disk drive using H P-UX commands: 

Step 1. Back up the files on the disk drive to be moved; seethe backup chapter in 
Managing Systems and Workgroups. 

Step 2. If you are moving a root LVM disk, execute the ivinboot -vcommandto 
view the current configuration. Record the information. For example, 

/usr/sbin/lvlnboot -v 


Boot Definitions 
Physical Volumes 
/dev/dsk/cOt 6d0 
Root: Ivoll on: 
Swap: lvol2 on: 
Dump: lvol3 on: 


for Volume Group /dev/vgOO: 
belonging in Root Volume Group: 
(56/52.6.0) Boot Disk 
/dev/dsk/c0t6d0 
/dev/dsk/c0t6d0 
/dev/dsk/c0t6d0 


Step 3. Notify users that the system will be shut down to move the disk. You can 
use the wall command and/or the interactive capabilities of the 
shutdown command to broadcast a message to users before the system 
goes down. See wall (IM) or shutdown (IM) in the H P-UX Reference 


Step 4. If your system is an NFS server and filesystems on the disk you are 

movi ng are exported, 

a. Find the NFS clients by logging in to the NFS server and looking at 
the /etc/exports file. Refer to exports (4) in the FI P-UX Reference 

b. Notify the users on the NFS client systems that data on the disk 
being relocated will be inaccessibletemporarily (users on a diskless 
system will be unable to use their system at all). 

c. Unmount the file systems from the NFS client. If you do not unmount 
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the file systems from the client, the cl lent will receive NFS error 
messages when accessing the files on the disk. 

There are several methods to unmount the NFS client filesystems: 

• Enter the Remote Administration area of SAM on the NFS server 
and unmount the file systems remotely. 

• Log in directly to each NFS client and unmount the file systems 
using either SAM or FIP-UX commands. 

Refer to the file systems chapter of the Managing Systems and 
Workgroups for specific instructions on unmounting file systems. For 
detailed information on Network FileSystems, refer to I nstalling and 
Administaing NFS Services. 

Step 5. If you are moving an LVM disk which is not being used for the root file 
system, 

a. Execute a vgdispiay -V command to display the contents of the 
active volume groups. (When moving an LVM disk, most of your LVM 
commands will be based on the volume group to which the disk 
belongs.) 

b. Execute ivdisplay -V for every logical volume in thevolumegroup 
of the disk being removed to locate any logical volumes currently 
straddling the disk being moved and another disk. If you find any, 

• Back up the data and remove the logical volume, by executing an 
ivremove command. 

Or, if the logical volume is mirrored, 

• Remove the mirroring, by executing an ivreduce -m o command. 

c. Execute a vgchange command to deactivate the volume group to 
which the disk is being added. 

d. If the disk comprises an entire volume group, execute a vgexport 
command to remove it from the current configuration. 

If the disk comprises a portion of a volume group, execute a vgreduce 
command. 

The disk is now free to be used as desired. 

Step 6. Determine the hardware address for the new location. Look at the 
Flardware Path field of ioscan output to make sure you choose an 
unused hardware address. 
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Step 7. If you are moving a disk drive containing the root file system (and you 
want to continue to use it as root), you will need to makesure the auto 
file on the root disk boot area does not specify a hard-coded hardware 
path. To check this, 

a. Locate the root disk by executing mount or bdf and looking for the / 
entry. 

b. View the current contents of the auto file by executing the lifcp 
command and using - to display the output. For example, 

bdf 

Filesystem kbytes used avail %used Mounted on 

/dev/dsk/clt6d0 1813487 467756 1164382 29% / 

hera:/users 3916236 2978782 545830 85% /hera/home 

/usr/bin/lifcp /dev/dsk/clt6d0:AUTO - 

hpux (;0)/stand/vmunix 

The output from lifcp should appear just as in this example. If 
instead, you see output that shows an explicit hardware path (for 
example, hpux 

(5 6.6.0 ; 0 ) / stand/vmunix), yoU wi 11 need tO Update the AUTO fi I e. To 
do so, execute the mkboot command with the -a option and verify 
your results: 

/usr/sbin/mkboot -a "hpux (;0)/stand/vmunix" 

/dev/dsk/clt6d0 

/usr/bin/lifcp /dev/dsk/clt6d0:AUTO - 

hpux (;0)/stand/vmunix 

• Oncethehardwarepath is removed, thesystem will bootusingthe 
path selected from processor-dependent code. 

• The ; 0 specifies that you are dealing with the entire disk. 

• /dev/dsk/cit6d0 is the device special file for the current location 
of the root disk. 


CAUTION The mkboot command overwrites the contents of the autoboot string. 


Step 8. If your /stand/system file includes (optionally) an explicit reference to 
the location of swap and/or dump, and these are located on the disk being 
moved, your kernel wi 11 have to be rebui It for the operati ng system to 
find the new locations. 
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a. Change directory to the build environment (/stand/build). There, 
execute a system preparation script, system_prep, which extracts the 
system file from the current kernel, as follows: 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

The system_prep script writes a system file in your current directory 
(that is, it creates /stand/buiid/system). The -V gives verbose 
explanation as the script executes. 

b. Manually edit the /stand/buiid/system file to reflect the new 
hardware path(s). 


NOTE Do not use the kmsystem command to perform this step; edit the file 

directly. 


c. Build the kernel by invoking the command 

/usr/sbin/mk_kernel -s /stand/buiid/system 

The mk_kernel command creates /stand/build/vmunix_test, a 

kernel ready for testing. 

d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/buiid/system /stand/system 

e. Prepare for rebooting by invoking the kmupdate command. This 
action sets a flag that tells the system to use the new kernel when it 
restarts. 

/usr/sbin/kmupdate 

Step 9. Shut down and halt your system usi ng the /usr/sbin/shutdown -h 
command. 

Step 10. Turn off the peripheral devices (including the disk drive) and then your 
SPU. 

Step 11. Physically movethedisk drive and writedown its new hardware location 

Step 12. Power up all peripheral devices, wait for them to indicate "ready", and 
then power on the SPU. 
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Step 13. If you are movingadiskcontainingthe root filesystem, you must change 
the hardware path that is read from stable storage: 

a. Start up your system, but override the autoboot. Do not boot from the 
primary or alternate boot path. I nstead, enter Boot Administration 
mode. (Note, boot ROM administration is system-dependent, and thus 
differs for Series 700 and 800 systems. The boot ROM menus, 
however, are self-explanatory. Use one of the help commands (Help or 
?) whenever you are uncertain of what to do. 

b. On a Series 700, boot from the new hardware address of your root 
disk by using the Boot command and proceed to the initial system 
loader. For example, 

BOOT-ADMIN> boot 2/0/1.4.0 is 

On a Series 800, enter the new hardware address of your root disk 
and boot your system. For example, if your new hardware address is 
52.1, enter b 52 . 1 . 

Answer Y to the prompt: interact with ipl? This will invokethe 
initial program loader. 

c. Set the system's primary boot path in stable storage to the new 
hardware address, by using theprimpath command at the isl> 
prompt. The system will prompt you to enter the primary boot path. 

d. Verify the contents of your auto file, this time, by executing the 
Isautof 1 command. You should see hpux (; O) / stand/vmunlx. 

e. Boot your system by typing in the contents of the auto file. Note, if 
you have moved a root LVM disk, boot to LVM maintenance mode by 
using the -im option. 

For example, 

ISL> hpux boot (;0)/stand/vmunix 

or 

ISL> hpux -Im boot (;0)/stand/vmunix 

This command loads the kernel from the FIP-UX filesystem and 
transfers control tothe loaded device. On booting up, insf identifies 
all devices it finds (including the newly moved disk) and creates /dev 
files for them. 

Step 14. Log in. 

Step 15. If you have moved an LVM root disk, proceed through the following 

sequence of commands to gain access tothe root disk at the new location: 
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a. Execute a vgchange command to reactivate the root volume group. 

b. Execute an ivinboot command to view the logical volumes in the 
volume group. 

c. Execute an ivrmboot command to remove the current definitions of 
root, swap, and dump from the disk's Boot Data Reserved Area. 

d. Execute ivinboot commands to redefine root, swap, and dump. Use 
the -V option for verbose output. 

e. Execute a vgchange command to deactivate the root volume. 

f. Reboot the system. 

For example, if root is redefined as ivoii, swap as ivoi2, and dump as 

lvol3. 


/usr/sbin/vgchange 
/usr/sbin/lvlnboot 
/usr/sbin/lvrmboot 
/usr/sbin/lvlnboot 
/usr/sbin/lvlnboot 
/usr/sbin/lvlnboot 
/usr/sbin/vgchange 
/usr/sbin/reboot 


-a y /dev/vgOO 

-V 

-r /dev/vgOO 
-r /dev/vgOO/lvoll 
-s /dev/vg00/lvol2 
-d /dev/vg00/lvol3 
-a n /dev/vgOO 


Step 16. Identify the device files corresponding to the newly moved disk, by using 
/usr/sbin/ioscan -fun -c disk and looking for the disk's hardware 
path. Write down the name of the new block device special file. 

Step 17. Create a backup copy of the /etc/f stab file: 


cp /etc/fstab /etc/fstab.old 

Step 18. Edit /etc/fstab to include the block device special fileof thedisk at its 
new location. 


Once edited, the /etc/fstab file will provide accurate information to the 
mount command. If the newly located disk is not the root disk, you may 
now mount it. (If the newly located disk is the root disk, it has been 
mounted already by other means.) 

/usr/sbin/mount -a 

Step 19. If your system is an NFS server, remount the file systems on its clients. 
Do so by executi ng the mount command on the NFS cl ient systems. 

Step 20. Update any software application configurations that use the relocated 
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disk drive to make sure they use the new device files. Refer to your 
software application documentation for specific instructions. 
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Removing a Disk Drive 

step 1. Back up the data on the disk drive; see the backup chapter of M anagi ng 
Systems and Workgroups. 

Step 2. If your system is an NFS server and filesystems on the disk you are 
movi ng are exported, 

a. Find the NFS clients by logging in to the NFS server and looking at 
the /etc/exports file. Refer to exports (4) in the FI P-UX Reference 

b. Notify the users on the NFS client systems that data on the disk 
being relocated will be inaccessibletemporarily (users on a diskless 
system will be unable to use their system at all). 

c. Unmount the file systems from the NFS client. If you do not unmount 
the file systems from the client, the client will receive NFS error 
messages when accessing the files on the disk. 

There are several methods to unmount the NFS client filesystems: 

1. Enter the Remote Administration area of SAM on the NFS server 
and unmount the file systems remotely. 

2. Log in directly to each NFS client and unmount the file systems 
using either SAM or FI P-UX commands. 

Refer to the file systems chapter of the Managing Systems and 
Workgroups for specific instructions on unmounting file systems. For 
detailed information on Network FileSystems, refer to Installing and 
Administering NFS Savices. 

Step 3. Create a backup copy of the /etc/f stab file (cp /etc/fstab 
/etc/f stab. old). 

Edit /etc/fstab to remove any mount entries for the disk being 
removed. Update the /etc/fstab on all NFS client systems to remove 
the mount entries for file systems that are on the disk drive being 
removed. 

Step 4. If you are removing an LVM disk, 

a. Execute a vgdispiay -V command to display the contents of the 
active volume groups. (When moving an LVM disk, most of your LVM 
commands will be based on the volume group to which the disk 
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belongs.) 

b. Execute ivdisplay -V for every logical volume in the volume group 
of the disk being removed to locate any logical volumes currently 
straddling the disk being moved and another disk. If you find any, 

• Back up the data and remove the logical volume, by executing an 
ivremove command. 

Or, if the logical volume is mirrored, 

• Remove the mirroring, by executing an ivreduce -m o command. 

c. Execute a vgchange command to deactivate the volume group to 
which the disk is being added. 

d. If the disk comprises an entire volume group, executea vgexport 
command to remove it from the current configuration. 

If the disk comprisesa portion of a volume group, execute a vgreduce 
command. The disk can now free be removed. 

Step 5. Notify the users on the system about system shutdown as a result of 
removing the disk drive. 

Step 6. Shut down and bring your system into single-user mode using the 
shutdown command. 

Step 7. If you are removing the disk drive your kernel uses for primary swap and 
dump, reconfigure the kernel to reassign them. Refer to the file systems 
chapter of the System Administration Tasks. 

Step 8. H alt the system: 

/usr/sbin/reboot -h 

Step 9. Turn off any peripherals attached to the computer system and then the 
SPU. 


Step 10. Turn off, unplug, and disconnect the disk drive. 

Step 11. Turn on any peripherals attached to the computer system and then the 
SPU. On booting up, insf identifies all devices it finds and creates /dev 
files for them. 

Step 12. Login. 

Step 13. Update any software application configurations that use the removed 

disk drive. Refer to your software application documentation for specific 
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Finding Out the Disk Model Number and 
Other Information 

The diskinfo command displays useful information about a disk. 
Execute it specifying the disk's character device special file. For example, 

/usr/sbin/diskinfo /dev/rdsk/clt2d0 

SCSI describe of /dev/rdsk/clt2d0: 
vendor: HP 
product id: C3010M1 

type: direct access 
size: 1956086 Kbytes 
bytes per sector: 512 

SCSI disks can be further identified by the product ID field. The number 
displayed does not correspond to the H P model number of the disk, but 
rather to an "inquiry response" derived from querying the disk firmware 
itself using a SCSI inquiry command. The inquiry response often 
resembles a product number or product number family. (For example, 
disks C243xand C2440all report C2430D.) 

If you have a disk hardware problem and are working with an FI P service 
engineer, reporting the inquiry response gives him or her with useful 
information such as firmware revision, disk mechanism, form factor, and 
capacity. 
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After Configuring HP-UX for the Disk Device 

After configuring HP-UX for a disk device, you may complete the tasks 
required to put it to use. These include: 

• Setting up powerfail capabilities for the disk or disk array. 

• Setting up or modifying RAID levels for a disk array, if necessary. 

• Adding a disk to an LVM volume group. 

• Mirroring the disk. 

• Defining logical volumes in LVM. 

• Making the disk availablefor swapping. 

• Creating or moving file systems onto the disk. 

• Exporting the disk using NFS capabilities. 

• Controlling access to the information on the disk. 

• Controlling disk usage by implementing disk quotas. 

• Integrating the disk into your backup strategy. 

• Restoring data to the disk from other disks. 

• Moving file systems to more equitably use your disk space. 

• Arrange to mount file systems on the disk at bootup. 

• Creating a recovery system for the data on the disk, particularly if 
this is the root disk. 

For these tasks, refer to information in the hardware manuals. 
Managing Systems and Workgroups manual and the HP-UX Reference 
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Configuring Magneto-Opticai 
Devices 


Magneto-optical disks and magneto-optical disk library systems are 
SCSI devices used for high-capacity read-write applications. The ability 
of magneto-optical devices to randomly access vast amounts of data 
makes them best suited for fast retrieval of infrequently accessed 
archival data, unattended backup, and storage of large data files such as 
electronic images. 

Data can be written tothe optical disks in raw mode or as files; cpio, dd, 
and other H P-UX commands can access optical disks in raw or block 
mode. LVM can be used to configure partitions on magneto-optical 
devices. Note, however, that LVM is not supported for spanning disks on 
magneto-optical devices. 

Typically, magneto-optical disk libraries require installation by an HP 
Service Engineer. 


Magneto-optical devices are shipped with a shipping screw in pi ace to 
ensure that the product is not damaged in transit. Consult the hardware 
documentation for instructions on removing the shipping screw before 
configuring the device. 
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Planning to Configure a Magneto-Optical 
Device 

Magneto-optical disk devices are configured into the operating system 
much likea SCSI hard disk drive. Choosethe devicedrivers that must be 
present in the kernel for H P-UX to communicate with your 
magneto-optical device based on: 

• whether you are configuring a single disk or a magneto-optical disk 
library 

• the architecture and interface to which you are configuring the 
device. 

Characteristics of Magneto-Optical Devices 

Magneto-optical devices yield good performance if data is distributed 
properly within its structural framework. 

The size of an individual magneto-optical disk device makes it suitable 
for use as a boot disk, though its performance does not match that of a 
standard hard disk. Series 800 systems cannot be booted from 
magneto-optical devices. 

Magneto-optical disk libraries contain multiple optical disks and 
multiple optical drives. HP offers several magneto-optical disk library 
products, with various capacity ranges and hardware configurations. 

Each magneto-optical disk has two surfaces (sides), each of which 
appears to H P-UX as if it were an entire disk that can be used for a 
mountable file system or for raw access. Optical disk surfaces may be 
kept on- or off-line, as use requires. You may access simultaneously only 
as many autochanger surfaces arethereareautochanger drives. (This is a 
change in implementation.) SAM will also allow access to only as many 
surfaces as there are drives. 


If you exceed the number of drives, the request for the additional surface 
will either wait (sleep) without timeouts, or it will fail with an ebusy 
error (indicating the device is currently busy). The resultant behavior 
depends on the specific operation. Requests to execute mount, 
mediainit, or newfs on surfaces will fail with an ebusy error when all 


138 


Chapters 






Table 5-1 


Configuring Magneto-Opticai Devices 

Planning to Configure a Magneto-Optical Device 

the drives are used. Other commands (such as raw access with cpio or 
dd) will wait (sleep) until a drive is available. 


Understanding Magneto-Optical Media Capacity 

Magneto-optical disk mechanisms support several different capacities: 

• C17xxA and C17xxC products support IX capacity disks. 

• C17xxT and CllxxA products support IX and 2X capacity disks. 

• CllxxF, CllxxG, and CllxxH products support 4X capacity disks. 

• CllxxJ, CllxxK, and CllxxL products support 8X capacity disks. 

HP-UX supports disks with 512, 1024, or 2048 bytes per sector, for IX, 
2X, 4X, and 8X capacity. Disks with more bytes per sector give more 
storage space per disk, duetoa smaller amount of sector overhead. 

Magneto-Optical Media Capacity by Size 


Sector Size 

Total Size 

IX Capacity 

Total Size 

2X Capacity 

Total Size 

4X Capacity 

Total Size 8X 
Capacity 

512 bytes 

600 MB 

1.2 GB 

2.3 GB 

4.2 GB 

1024 bytes 

650 MB 

1.3 GB 

2.6 GB 

4.8 GB 

2048 bytes 

- 

- 

- 

5.2 GB 


You can determi ne the medi a by executi ng the diskinfo command, 
diskinfo output for magneto-optical disks shows the information for the 
specific surface queried, not for the disk as a whole. The size in this 
example corresponds to the number of bytes on one surface of a 
IX-capacity magneto-optical disk, with a sector size of 1024 bytes. (A 
2X-capacity magneto-optical disk would show 581668 Kbytes.) 

/usr/sbin/diskinfo /dev/rac/c0tld0_4a 

SCSI describe of /dev/rac/c0tld0_4a: 
vendor: HP 
product id: C1716T 

type: optical memory 
size: 314568 Kbytes 
bytes per sector: 1024 
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Table 5-2 


Magneto-Optical Disk Configuration 
Guidelines 

This section identifies the device drivers that must be configured into 
HP-UX for it to communicate with singiemagneto-opticai disks, if you 
are configuring a magneto-opticai disk iibrary or adding an opticai disk 
to an existing magneto-opticai disk iibrary, refer to the section, 
"Magneto-Opticai Disk Library Configuration Guideiines." 

Tabie5-2, "Magneto-Opticai Disk Configuration Requirements," iists the 
device drivers required to configure a magneto-opticai disk to 
singie-ended SCSi interface for each supported architecture. 


Magneto-Optical Disk Configuration Requirements 


Architecture 

Interface 

Card 

Interface 
and Device 
Drivers 

Default Device File 

Series 700 ^ (core 
I/O only) 

(internal) 

sdisk*’ 

/dev/[r]dsk/c#t#d#[ 
s#]" 

Series 800 CIO"* 

27147A 

scsi2‘* 

(same as above) 



disc3® 


Series 800 

HP-PB^* 

28655A 

scsil^ 

(same as above) 



discs'’ 



a. The following optical disks [listed with their respective product ID 
strings returned by SCSI Inquiry] can be configured to a Series 700 
single-ended SCSI interface, Series 800 CIO or HP-PB single-ended 
SCSI interface: CI70IA [S6300.650A], CI70IC [CI7I6C], C2550B 
[CI7I6T]. 

b. Specifying sdisk causes sctl, c700, and wsio drivers to be 
included automatically in the kernel. 
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c. c#t#d# [s#] derives from ioscan output: c# is the card instance for 
the class of interface card to which the device is attached, t# is the 
address of the device on the interface, d# is the device unit number, s# 
specihes section number and is shown for backward compatibility; the 
entire disk (sO) is assumed when s# is unspecihed. 

d. Specifying scsi2 causes cio_caO to be included in the kernel. 

e. Specifying disc3 causes target to be included in the kernel. 

f. Specifying scsil causes sio, pfail, and pa drivers to be included in 
the kernel. 


Configuring HP-UX for a Magneto-Optical Disk 

This section gives instructions on configuring H P-UX for a singie 
magneto-opticai disk. Configuring a singie magneto-opticai disk is done 
aimost identicaiiy to configuring any hard disk to a singie-ended SCSi 
interface card: 

Step 1. Seiect the device dri vers from the tabie,Tabie 5-2, "Magneto-Opticai 
Disk Configuration Requirements," in the previous section. 

Step 2. Foiiow the procedure, "Configuring HP-UX for a New Disk Device", in 
Chapter 4 , "Configuring Disk Drives, Disk Arrays, and CD-ROM 
Drives." 

Step 3. Uniess you have purchased the disk preformatted, you may need to run 
mediainit to initiaiizethe media. Refer to the hardware documentation 
or mediainit (1) in the HP-UX Reference 

If you are configuring an magneto-optical disk library, refer to the next 
section, "Magneto-Optical Disk Library Configuration Guidelines". 


If you are configuring an existing 9.x magneto-optical disk to an H P-UX 
10.0 system, be sure to read and follow the precautions detailed in the 
sections entitled "Planning to Configure into your System a Disk Already 
Containing Data" and "Ensuring Against Clashes with HP-UX 10.0", 
both located in Chapter 4 , "Configuring Disk Drives, Disk Arrays, and 
CD-ROM Drives,"of this manual. 
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Magneto-Optical Disk Library Configuration 
Guidelines 

This section gives information pertinent to configuring a magneto-opticai 
disk iibrary. if you are configuring a si ngie magneto-opticai disk, refer to 
the previous section, "Magneto-Opticai Disk Configuration Guideiines". 

Tabie5-3, "Magneto-Opticai Disk Library Configuration Requirements," 
iists the device drivers required to configure a magneto-opticai disk 
iibrary toa singie-ended SCSi interface for each supported architecture. 

Magneto-Optical Disk Library Configuration Requirements 


Architecture 

Interface 

Card 

Interface 
and Device 
Drivers 

Default Device Files 

Series 700 
(core I/O only) 

(internal) 

ssrfc*’ 

schgr 

sdisk*^ 

/dev/[r]ac/c#t#d#_#[ 
a|b]‘* 

Series 800 CIO'^ 

27147A 

scsi2® 

ssrfc*’ 

autoxO 

disc3^ 

(same as above) 

Series 800 

HP-PB^* 

28655A 

scsil® 

ssrfc*’ 

autoxO 

disc3^ 

(same as above) 


a. The following optical disk libraries are supported on Series 700 (core 
single-ended SCSI only) and Series 800 HP-PB buses; Cl lOOA, 
(C1150A), (C1160A), (C1170A), C1700C/T, C1704A/C/T, 
C1705A/C/T, C1708C/T. (Models shown in parenthesis are obsolete 
and are listed for reference only.) 

b. Disks in an optical disk library must be accessed through the ssrf c 
driver;lthey cannot be accessed directly through the SCSI disk driver 
(sdisk or disc3). Also see autochanger{l). 
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c. Specifying schgr or sdisk causes sctl, c700, and wsio to be 
included in the kernel. 

d. c#t#d# derives from ioscan output: c# is the card instance for the 
class of interface card to which the device is attached, t# is the 
address of the device on the interface, d# is the device unit number. 

# [a I b] specihes disk platter number and surface. 

e. Specifying scsi2 causes cio_caO to be included automatically in 
the kernel. 

f. Specifying disc3 causes target to be included automatically in the 
kernel. 

g. Specifying scsil causes sio, pfail, and pa drivers to be included 
in the kernel. 


Configuring HP-UX for a Magneto-Optical Disk 
Library 

The simplest way to configure a magneto-optical disk library istouse 
SAM (/usr/sbin/sam). If SAM Is not loaded on your system or If you 
prefer to use the command-line interface, the following procedure will 
guide you through the task. Understand the instructions before getting 
started. 

Step 1. On your host computer system, invoke /usr/sbin/ioscan -fn to figure 
out what addresses are avail able on the SCSI interface to which you'll be 
attaching the optical disk library. 

Observethefollowing single-ended SCSI guidelines: 

• Each host adapter card has a maximum of seven available SCSI 
addresses (6-0) in order of descending priority, with address seven 
reserved for the host adapter. 

• The optical disk library systems (CllxOA and C17xxA/C/T) use up to 
five SCSI addresses —one for each of the magneto-optical diskdrives 
and one for the autochanger mechanism. 

• Observethe maximum single-ended SCSI cable length of six meters. 

Step 2. Using the hardware documentation as your primary source: 

• Physically set up the optical disk library (separate from the host 
system). 

• Assign unique SCSI addresses to each disk drive and autochanger 
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mechanism and record the information. 

• Run the recommended tests. 

Step 3. ConsuitTabie 5-3, "Magneto-Opticai Disk Library Configuration 
Requirements," to determine the device drivers needed for your 
magneto-opticai disk iibrary and interface, if any necessary static device 
driver is absent from the kernei, you wiii need to rebuiid the kernei to 
inciude it. Here is how to do so: 

a. Change directory to the buiid environment (/stand/build). Execute 
a system preparation script, system_prep, which extracts the system 
fiiefrom the current kernei and writes a system fiie in your current 
directory. (That is, it creates /stand/buiid/system.) The -v gives 
verbose expianation as the script executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

b. Modify the /stand/build/system fiieto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 

description fiies directiy. instead, use the commands kmsystem and 
kmtune. These commands are new for Reiease 11.0; consuit kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


c. Bui id the new kernei by invoking the mk_kernei command. This 
creates /stand/buiid/vmunix_test, a kernei ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the oid system fiie by moving it. Then move the new system fiie 
into pi ace. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Preparefor rebootingby i nvoki ng the kmupdate command. This sets a 
flag that teiis the system to use the new kernei when it restarts. 

/usr/sbin/kmupdate 
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Step 4. Notify users that the system will be shut down to configure the optical 
disk library. You can use the wall command and/or the interactive 
capabilities of the shutdown command to broadcast a message to users 
before the system goes down. (See wall (IM)or shutdown (IM) in the 
HP-UX Reference) 

Step 5. B ri ng the system down to a halt usi ng the shutdown command. 

Step 6. Turn off the power to all peripheral devices and then totheSPU. 

Step 7. Attach the optical disk library to the host computer system, foil owing the 
instructions and using the cabling recommended in the hardware 
documentation. Make sure the last device in the SCSI chain is 
terminated. 

steps. Turn on the power to all peripheral devices, including the optical disk 
library. Wait for the peripheral devices to become ready, then turn on 
power to the SPU. 

On booting up, HP-UX detects the optical disk library and associates it 
with its device drivers, insf creates the character and block device 
special (/dev) files required to communicate with each disk surface in 
the optical disk library. By default, insf creates device special files for 32 
optical disks (64 device special files for the surfaces plus a device special 
file for the autochanger). 

If you are configuring a larger-capacity magneto-optical library system, 
you will need to create device files for the remaining slots. To do so, 
execute the following command: 

/usr/sbin/insf -e -p <f±rst_optical disk:last_optical disk> -H 
<H/W_path> 

Step 9. Verify the configuration by invoking the loscan command on the address 
to which the disk library was configured. 

As shown in excerpted output run on a Series 700, a magneto-optical 
autochanger displays two entries — one for the autochanger mechanism 
(in this case, C1708C) and one for the disk mechanism (C1716C) — each 
with its own set of block and character device special files. 

/usr/sbin/ioscan -H 2/0/1 -fn 

Class I H/W Path Driver S/W State H/W Type Description 


ext_bus 0 2/0/1 c700 CLAIMED INTERFACE Built-in SCSI 
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target 2 2/0/1.0 

autoch 0 2/0/1.0.0 


target CLAIMED 

schgr CLAIMED 

/dev/ac/c0t0d0_10a 
/dev/ac/c0t0d0_10b 
/dev/ac/c0t0d0_lla 
/dev/ac/c0t0d0_llb 
/dev/ac/c0t0d0_12a 

/dev/ac/c0t0d0_31b 
/dev/ac/c0t0d0_32a 
/dev/ac/c0t0d0_32b 
/dev/rac/cOtOdO 


DEVICE 

DEVICE HP 
/dev/rac/c0t0d0_10a 
/dev/rac/c0t0d0_10b 
/dev/rac/c0t0d0_lla 
/dev/rac/c0t0d0_llb 
/dev/rac/c0t0d0_12a 

/dev/rac/c0t0d0_31b 
/dev/rac/c0t0d0_32a 
/dev/rac/c0t0d0_32b 


C1708C 


/usr/sbin/ioscan -H 2/0/1.1.0 -fn 

Class I H/W Path Driver S/W State H/W Type 


Description 


disk 


2 / 0 / 1 . 1.0 


sdisk CLAIMED DEVICE HP 

/dev/dsk/cOtldO /dev/rdsk/cOtldO 


C1716C 
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After Configuring a Magneto-Optical Device 

Once you have configured a magneto-optical disk, it can be used like any 
other disk. You will find its performance somewhat slower than a hard 
disk but faster than a floppy disk. 

Consult the Optical Disk Library System Administrator's Guidethat 
accompanied the hardware for procedures on the following: 

• initializingthedisk surfaces. 

• creating file systems on the optical disk devices. 

• mounting the optical disk surfaces. 

• using the optical disk library as a boot or swap device. 

• using write-once disks. 

• removing the optical disk library. 

Also, refer to the section, "After Configuring H P-UX for the Disk Device" 
for a list of potentially pertinent tasks. 
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Several kinds of tape drives, having different recording methods and 
formats, can be configured to H P-UX: 

• nine-track reel-to-reel tape drive 

• cartridge tape drive (configured like a disk device) 

• QIC tape drive 

• DDS (DAT) tape drive 

• 8mm Exabyte tape drive 

• 3480-style cartridge tape drive 

Despite their differences, any of these tape drives can be configured into 
HP-UX by the same basic procedure: 

1. Select the device drivers, based on the interfaceto which the tape 
drive is attached, and includethem in the kernel. 

2. Set the tape drive to a unique address on the interface bus. 

3. Follow the steps documented in this chapter to configure HP-UX for 
the device. 

Once you reboot the system with the tape driver installed and 
configured, insf automatically creates the device special files that 
enable you to use the features of the specific tape drive technologies. 

You will create customized device special files (using mksf) only for 
special circumstances, such as when you have to write a tape on a tape 
drive that supports data compression, but you intend to read it on a tape 
drive that does not support data compression. Examples are given in 
"Creating Customized DeviceSpecial Files for Tape Devices" later inthis 
chapter. 
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Selecting Device Drivers for a Tape Device 
and I nterface 

The following sections will help you identify the device drivers needed to 
configure a tape drive. Choose the drivers based on the interface to which 
the tape drive is being connected. 

SCSI Tape Drive Configuration Guidelines 

Each single-ended SCSI interface card has a maximum of eight SCSI 
addresses, ranging in order of decreasing priority from i to 0 , with SCSI 
address i reserved for the host adapter card. Use o, the lowest priority 
address available, for low-performance tape-drive configuration. 

H igh-performance tape drives will need a higher priority. 

When usi ng an STK 3480 tape drive, connect the device to its own 
external SCSI host adapter in the SPU to prevent the possibility of data 
corruption if the bus glitches when the tape drive is powered down. 
Follow manufacturer's recommendations in hardware manuals. 

3480 devices aresupported as "reference" devices on H P-UX; that is, they 
are supported to a limited degree. A third-party application is needed to 
read/write IBM-compatible tapes on HP-UX systems. (Seemt (7)) in the 
HP-UX Reference for additional limitations.) 

Where possible, connect the 7980S/SX and C2463F/R tape devices to 
their own external SCSI bus, to prevent possible data corruption from 
controller glitches. 


NOTE By default, insf creates device special files that write tapes with data 

compression enabled if the tape drive doing the writing supports data 
compression. If you have to write a tape on a tape drive that supports 
data compression, but you need to read it on a tape drive that does not 
support data compression, you must create the tape using a device 
special file with data compression disabled, using mksf. See "Creating 
Customized Device Special Files for Tape Devices", later in this chapter, 
for an example. 


Table 6-1, "SCSI Tape Drive Configuration Requirements," shows the 
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Table 6-1 


configuration requirements for the single-ended SCSI tape drives. 

SCSI Tape Drive Configuration Requirements 


Architectu 

re 

Interface 

Card 

Interface 
and Device 
Drivers 

Default Device Special Files 

Series 700 

Core I/O 

(internal) 

stape'’ 

/dev/rint/c#t#d#BEST [b | n | 
nb]‘' 

/dev/rmt/c#t#d#[f#1i#][b 

1 n 1 nb] 

/dev/rmt/#m[b|n|nb]® 

Series 700 

EISA"* 

25525A/B 

stape*’ 

(same as above) 

Series 800 

010"“ 

27147A 

■ of 
scsi2 

tape2® 

(same as above) 

Series 800 

HP-PB 

28655A 

scsil’ 

tape2® 

(same as above) 


a. The following tape drives are supported for HP-UX on a single-ended 
SCSI interface: (7980S/SX), A2311A, A2656A, A2944A, A2944A, 
A3024A, (C1502A), C1503A/B/C, C1504A/B/C, (C1512A), 
C1520A/B, C1521B, C1530B, C1533A, C1534A, C1535A, C1553A, 
C2292A, C2297T/U, C2298A, (C2463F/R), C2464F/R, C2465R, 
C2466F/R, C2467F/R, C2477F/R/S/U, C2478U, C2954A. (Obsolete 
models are shown in parenthesis for reference only.) 

b. Specifying stape causes sctl, c700, wsio, and core drivers to be 
included automatically in the kernel. 
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c. Naming convention for systems installed with long file names. 
c#t#d# derives from ioscan output: c# is the card instance number 
for the ext_bus class of interface card to which the tape drive is 
attached, t# is the SCSI address, d# is the device number. BEST 
represents the operational capabilities likely to be required, including 
the highest density/format and data compression, if supported by the 
device, [b | n | nb] designates tape positioning: b is Berkeley-style; 
that is, after hie close, the tape is not repositioned in any way. If b is 
not designated, AT&T-style tape closing occurs; that is the tape might 
be positioned after the end-of-hle (EOF) point, n designates no 
rewind. 

d. Naming convention for systems installed with short hie names. For 
c#t#d#, see footnote 100. f# represents the highest density/format 
and data compression, if the device supports it. Or, i# represents a 
pointer into a tape-device property table. For [b | n | nb], see footnote 
100. 

e. Syntax available for backward compatibility. # designates tape drive at 
# card instance. The #m, #mb, #mn, and #mnb device special hies are 
linked to c#t#d#BEST, c#t#d#BESTb, c#t#d#BESTn, and 
c#t#d#BESTnb, respectively. 

f. Specifying scsi2 causes cio_ca0, sio, pfail, and pa drivers to be 
included automatically in the kernel. 

g. Specifying tape2 causes tape2_included to be included 
automatically in the kernel. 

h. Tape drives listed in footnote 1 are supported on Series 800 HP-PB 
architecture, as are A231 lA and A2312A. StorageTek models 4220 
and 4280 tape drives will also conhgure successfully using the HP-PB 
single-ended SCSI device driver; however, these tape drives must be 
the only peripheral device on their SCSI bus. 

i. Specifying scsil causes sio, pfail, and pa drivers to be included 
automatically in the kernel. 
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Configuring HP-UX for a Tape Drive 

The si mplest way to configure a tape drive is to use SAM 
(/usr/sbin/sam). If SAM is not loaded on your system or if you prefer to 
use the command-line interface, the following procedure will guide you 
through the task. Understand the instructions before getting started. 

Step 1. I nvoke /usr/sbin/ioscan -fn to figure out what addresses are 

available on the interface card to which you will be attaching the tape 
drive. 

For examples of ioscan usage, consult "Viewing the System 
Configuration with ioscan" in Chapter 1, "Getting Started." 

Step 2. Determine the device drivers needed for your tape drive and interface. If 
any necessary static device driver is absent from the kernel, you will 
need to rebuild the kernel to include it. 

a. Change directory to the build environment (/stand/build). There, 
execute a system preparation script, system_prep, which extracts the 
system file from the current kernel and writes a system file in your 
current directory. (That is, it creates /stand/buiid/system.) The -v 
gives verbose explanation as the script executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

b. Modify the/stand/build/system fileto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 

description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the H P-UX Reference 


c. Build the new kernel by invoking the mk_kernei command. This 
creates /stand/buiid/vmunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 
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d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Preparefor rebootingby invoking the kmupdate command. This sets a 
flag that tells the system to use the new kernel when it restarts. 

/usr/sbin/kmupdate 

Step 3. Notify users that the system will be shut down to configure the tape 

drive. You can use the wall command and/or the interactive capabilities 
of the shutdown command to broadcast a message to users before the 
system goes down. See wall (IM) or shutdown (IM) in the HP-UX 
Reference 

Step 4. Bring the system to a halt, using the shutdown command. 

Step 5. Turn off the power to all peripheral devices and then totheSPU. 

Step 6. Install the hardware, following instructions shown in the hardware 

documentation. When attaching the tape drive, set the switches on the 
tape drive to an unused address, which you will have determined from 
ioscan output. U se the cabi i ng recommended i n the hardware 
documentation. If installing a SCSI device, make sure the last device in 
the SCSI chain is terminated. 

Step 7. Turn on the power to all peripheral devices. Wait for them to become 
"ready", then turn on power totheSPU. 

On booting up, H P-UX detects the new tape drive and associates it with 
its device driver, insf creates the character device special files required 
to communicate with the tape drive. 

Step 8. Verify the configuration by invoking the ioscan command to confirm 

that the tape device is present and device special files have been created 
for it. 

I n the sample output shown, the tape driver at hardware path 
2/0/1 .3.0 can be accessed by one of eight device files. 
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/usr/sbin/ioscan -C tape -fun 


Class 


I H/W Path Driver 


S/W state H/W Type Description 


tape 


0 2/0/1.3.0 stape 


CLAIMED 


DEVICE HP354 


HP35480A 


/dev/rmt/Om 

/dev/rmt/Omb 


/dev/rmt/c0t3d0BESTn 
/dev/rmt/c0t3d0BEST 
/dev/rmt/c0t3d0BESTb 


/dev/rmt/Omn 

/dev/rmt/Omnb 


/dev/rmt/c0t3d0BESTnb 


Step 9. You can also use the tar command to verify that you can read and write 
to and from the device. I n the following example, the first tar command 
writes the /etc/passwd file to tape using a device special file shown in 
the ioscan output. Thesecond tar command displays the contents of the 
tape. 

/usr/bin/tar cvf /dev/rmt/c0t3d0BEST /etc/passwd 

a /etc/passwd 2 blocks 

/usr/bin/tar tvf /dev/rmt/c0t3d0BEST 

rrr 2/2 601 June 6 16:40 1994 /etc/passwd 
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Creating Customized Device Special Files for 
Tape Devices 

The default device special files created by insf handle most routine 
tape-drive requirements. For special circumstances, however, you can 
use SAM or the tape driver options of themksf command to create device 
special files. For complete syntax information, consult the SAM online 
help or mksf (IM) manpage in the FI P-UX Reference 

Examples 

I n each example, the tape device is at card instance 1 for the ext_bus 
class of i nterface card to which the tape device is attached, as shown by 

/usr/sbin/ioscan -fn OUtput. 

Reading a Tape on a Different Format Device 

Typically, a tape written on a Wangtek QIC 1000 device cannot be read 
on a Wangtek QIC 525 device. This is because the default device special 
file /dev/rmt/c#t#d#BEST will write in QIC 1000 format. 

To create the device file needed for writing QIC 525 format, use the 
following command. Also shown arethe resulting device special files. 

/usr/sbin/mksf -C tape -I 1 -b QIC_525 

/dev/rint/c#t#d#QIC525 on a system allowing long file names, or 

/dev/rint/c#t#d#f5 on a system requiring short file names 


NOTE I n short file name notation, f# (or i#, shown in next example) denotes 

device-dependent values. See mt (7) in the FI P-UX Reference for 
explanation. 


Allowing for Trial and Error 

If you are attempting to use a new tape device with the stape driver and 
you do not know exactly how to configure it, you can use the -e option to 
create a device file that will let the driver try several configurations to 
find one that will work. 
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The following shows the command line and resulting device special files: 

/usr/sbin/mksf -C tape -I 1 -e 

/dev/rint/c#t#d#eBEST on a system allowing long file names, or 

/dev/rint/c#t#d#i# on a system requiring short file names 


Avoiding Data Compression 

Sometimes an operation requires use of a device special filethat writes 
data without compression. For example, 

• On HP-UX, theSTK 3480 tape drive requires that if data cannot be 
compressed to fewer than 102,400 bytes, it must be written to tape 
without compression. 

• A tape created on an H P35480A wi 11 have been written with data 
compression enabled. To read the tape on an H P35470A tape drive, 
you must usea device special filethat does not compress data. 

To accomplish this, you cannot use the default best density because it 
will automatically compress the data. 

To create device special files for the STK 3480 that write data in 
uncompressed form, use the foil owing sample command. Also shown are 
the resulting device special files. 

/usr/sbin/mksf -C tape -I 1 -b D3480 

/dev/rint/c#t#d#D3480 on a system allowing long file names, or 

/dev/rint/c#t#d#f 1 on a system requiring short file names 

To create device special files for the HP35480A to write a tape in 
uncompressed form, use the foil owing sample command. Also shown are 
the resulting device special files. 

/usr/sbin/mksf -I 8 -C tape -b DDSl 

/dev/rmt/c#t#d#DDSl on a system allowing long file names, or 

/dev/rmt/c#t#d#f1 on a system requiring short file names 

This tape can now be read on a tape drive, regardless of whether or not it 
supports data compression. 
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After Configuring a Tape Drive 

The following manpages, found in the HP-UX Refaencegive 
specifications related to typical tape drive tasks and capabilities: 

cpio (1) Copyfilearchives in and out (cpio is not recommended 


dd (1) 

for use with 3480 products.) 

Convert, reblock, translate, and copy a file 

ftio (1) 

Faster tape I/O 

mediainit (1) 

1 nitialize disk or cartridge tape media; partition DDS 

mt(l) 

Magnetictape manipulating program 

nohup (1) 

Run a command immune to hangups, logouts, and 
quits 

pax (1) 

tar (1) 

Portable archive exchange 

tape file archiver 

tdo (1) 

Command set/80 (CS/80) cartridge tape utility 

backup (IM) 

cstm (IM) 

Backup or archive file system 

Command-line interface to the Support Tool Manager 

dump (IM) 

fbackup(lM) 

frecova (IM) 

1 ncremental file-system dump, local or across network 

Selectively back up files 

Selectively recover files 

install (IM) 

1 nstall commands 

ioscan (IM) 

Scan I/O system 

Issf (IM) 

List a special file 

mk_kernel (IM) 

Build a bootable H P-UX kernel 

mkrs (IM) 

Construct a recovery system 

mksf (IM) 

Make a special file 

restore (IM) 

Restore file-system incrementally, local or across 
network 

rmt (IM) 

Remote magnetic-tape protocol module 
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savecrash (IM) 

Save a core dump of the operati ng system 

scsicti (IM) 

Control a SCSI device 

swinstall (IM) 

1 nstall H P-UX software 

tar (4) 

Format of tar tape archive 

ct(7) 

Command set/80 (CS/80) cartridge tape access 

mt(7) 

Magnetic tape interface and controls 

scsi (7) 

Small Computer System 1 nterface device drivers 

scsi_ctl (7) 

SCSI device control device driver 


scsi_tape (7) SCSI sequential access (stape) device driver 
Other sources you may wish to consult include: 

• M anagi ng Systems and Workgroups 

• Managing HP-UX Software 

• HP OpenVie/v Software Distributor Administrator's Guide 

• HP Omni Back, Turbo-Store documentation 

• Documentation for any products you intend to install from tape 
media. 
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Configuring Printers and 
Piotters 


Baiausethey are output-only devices, printers and plotters are 
configured somewhat differently than other peripheral devices. 

There are three basic steps to printer and plotter configuration: 

• physically installing the printer or plotter (documented in the 
hardware manual shipped with the device). 

• configuring the H P-UX kernel for the device drivers to communicate 
with the printer or plotter. 

• setting up the H P-UX LP spooler to send print jobs to the printer or 
plotter and to recognize the printer or plotter's features. 

Printers and plotters are most easily configured for local, remote, or 
network access using SAM (/usr/sbin/sam). SAM creates the 
appropriate device files when adding a local printer and helps identify 
missing drivers if it cannot find a particular interface. 

If you configure a printer or plotter using the HP-UX command-line 
approach, you can use this chapter for the kernel configuration and then 
refer to the Managing Systems and Workgroups manual for instructions 
on setting up the LP spooler. 

If you are using something other than the default H P-UX spooler, consult 
the documentation accompanying that application for instructions on 
setting it up. 

Familiarize yourself with the various pieces of documentation before 
proceeding with the installation and configuration. 
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Preparing to Configure HP-UX for a Printer or 
Plotter 


Choosing Means of Access 

Pri nters and plotters can be connected to the system to be accessed 
locally, remotely, or through the network. I n the following example, the 
printer printl is physically connected to a system named sysl. 

/ - \ + - + + - + 

I printer | | HP-UX system | | HP-UX system | 

I printl |< —I sysl | | sys2 | 

\ - / + - + - + + - + - + 

I LAN I 

<===============+===================+=========> 

The physical connection might be serial (RS-232-C), parallel, or SCSI, 
depending on the system interface and printer, printl is connected as a 
local printer to sysl. The LP spooler on sysl is configured to include the 
local printer printl. Print requests generated on sysl are spooled directly 
to printl. 

Users on a system called sys2 can also access printer printl as a remote 
printer, provided the LP spooler on sys2 is so configured. (The remote 
printer can be named anything for users on sys2, but consistency in 
naming simplifies the configuration.) 

If you usethe HP-UX command-line interface, thecomplexities of setting 
up remote access are accomplished usingthelpadmin (IM) and 
rlpdaemon (IM)commands. 

I n the following example, the printer printl is accessed by both sysl and 
sys2 as a network printer, printl is connected directly to the LAN and 
has its own IP address. There is no direct connection (RS-232-C, parallel, 
or SCSI) between the printer and any HP-UX system ( sysl or sys2). 


/-\ I 

printer |<— | 

I printl I + 

\-+—/ 

I 

<=+====== 


HP-UX system | 
sysl I 

- + - + 

I 

I LAN 

: = = = = = = + = = = = = = = = : 


+-+ 

I HP-UX system | 

I sys2 I 

+-+-+ 




Configuring access to a network printer is more complex than 


> 
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configuring access to a local printer; HP recommends using the H P 
J etDirect Network I nterface, an optional product. SAM requires 
J etDirect configuration and hides any additional complexities. 

When a user generates a request to a configured network printer, the LP 
spooler on the system from which the request is generated sends the 
print request over the LAN to the printer. 

If printer printl is configured to a terminal using Terminal Session 
Manager (TSM) as shown in thefollowing exampe, only the user logged 
i nto that termi nal has access to the pri nter. 

+-+ +-+ +-+ 

/-\ I terminal | I HP-UX system | | HP-UX system | 

I printer |<--| using |—>| sysl | | sys2 | 

I printl I I TSM | +-+-+ +-+-+ 

\-/ +-+ I I 

I LAN I 

<================== = = = = +====================+== = = = = = = = > 

This chapter discusses configuration of local and remote printers and 
plotters only. For network configuration, use SAM and H P J etDirect. For 
TSM configuration, usetheTerminal Session Manager User's Guide 
Consult theX Station User's Guidefor the HP 700/ RX or HP VUE 3.0 
User's Guide for information on configuring a printer into an X or VUE 
environment. 

Hardware Concerns 

• Some plotters (particularly electrostatic plotters with vector-to-raster 
converters) are not customer installable. Attempting to install them 
might introduce defects which will invalidate your warranty. These 
prohibitions should be clearly noted in the documentation 
accompanying the plotter. Call your local HP Sales and Support 
Office for a certified representative to i nstal I and set up the H P 
plotter properly. A list of worldwide HP offices is included in the 
accessories package accompanying the plotter. 

• As shipped from the factory, the printer is likely to be set up to 
operate in parallel mode; if you intend to connect the printer to any 
other interface (that is, serial, SCSI, or using the network), you may 
need to reset hardware switches. Consult the printer hardware 
manual for information. 

• Follow any interface-specific recommendations given in the hardware 
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documentation regarding setting device address. 

Software Concerns 

• Consult the tables in "Selecting Device Drivers for Your Printer or 
Plotter" to identify the drivers compatible with the printer or plotter 
and interface to which it is being connected. 

• Once you have determined all of these items, proceed to the sections, 
"Configuring a Printer Using H P-UX Commands" and "Configuring a 
Plotter or other Non-Automatically Configurable Output Devices 
Using HP-UX Commands". 
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Selecting Device Drivers for Your Printer or 
Plotter 

Use this section toidentify the device drivers required for your printer 
configuration, based on the modei of printer or piotter and the interface 
to which it is attached. 

Guidelines for Configuring a Printer or Plotter to a 
Serial Interface 

• Check /etc/inittab to make sure you do not have a getty (for a 
terminai) spawned on the same seriai port to which you are 
configuring a printer or piotter. 

• Configure the printer or piotter's RS-232-C data transmission vaiues 
to be consistent with your computer's requirements. (These 
requirements are documented in the printer/pi otter manuai.) 

— baud rate 

— parity 

— dataiength 

— handshake 

— symboi or character set 

• Additionai steps may be required when configuring a printer or 
piotter to communicate through an HP Datacommunications and 
Terminai Controiier (DTC)or telnet port access. (Such asynchronous 
communication is usefui when connecting a printer to an X terminai, 
for exampie.) 

Refer tothechapter "Setting up Printers Using the HP-UX Spooier," 
in the DTC DeviceFiieAccess Utiiities and Teinet Port identification 
manuai. 

• Once you have configured a printer or piotter to a seriai port, foiiow 
the procedure "Creating a Device Speciai Fiiefor a Printer or Piotter 


Chapter 7 


165 





Table 7-1 


Configuring Printers and Piotters 

Selecting Device Drivers for Your Printer or Plotter 


Configured to a Serial Port". 

Serial Printer Configuration Requirements 


Architecture 

Interface Card 

Interface and 
Device 

Drivers 

Default Device File 

Series 700 

(internal) ^ 

asioO 

/dev/tty#p#’’ 

Series 800 CIO 

98196A‘= 

98190A 

mux‘* 

(same as above) 

Series 800 

HP-PB 

40299B‘=J2092A 
J2093A J2094A 
J2096A 
A1703-60022 

mux2® 

(same as above) 

Series 800 

HP-PB 

A1703-60003 ^ 
28639-60001 

mux4® 

(same as above) 


a. The following model printers can be configured to the Series 700 
serial interface: 2562C, 2563C, 2566B/C, 2567C, (33449A), 33459A, 
(C1645A), C1676A, C2001A, (C2010A), (C2106A), (C2113A), 
C2354A, C2356A. (Models in parenthesis are obsolete and are listed 
for reference only.) 

b. By default, insf creates the standard tty device file shown. For ease 
in system administration, HP recommends that you create the 
line-printer device file /dev/c#p#_lp, using /usr/sbin/mksf, as 
explained in “Creating a Device Special File for a Printer or Plotter 
Configured to a Serial Port”. The device naming convention derives 
from ioscan output: c# is the card instance for the tty class of 
interface card to which the device is attached and p# is the port to 
which the printer is attached. 

c. The following printer models can be configured to the Series 800 
serial interfaces: 2225D, 2227A, 2228A, 2235A/B/C/D, 2276A, 

2277A, 2562A/C, 2563A/B/C, 2564B/C, 2565A, (2566A), 2566B/C, 
(2567B), 2567C, 2684A, 2686A/D, (2932A), 2934A, (33440A), 
33447A, 33449A, 33459A, 33471A, 3630A, 41063A, C1200A, 
C1602A, C2001 A, C2106A, C2354A. (Obsolete models are shown in 
parenthesis and are listed for reference only.) 

d. Specifying muxO causes cio_ca0, sio, pf ail, and pa to be 
included in the kernel. 
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Table 7-2 


e. Specifying mux2 causes sio, pfail, and pa to be included in the 
kernel. 

f. These cards are typically used for console and remote console. If the 
second port is not being used for remote console, a printer may be 
attached. 

g. Specifying mux4 causes lanmuxO, lanttyO, lan3, sio, pfail, 
and pa to be included in the kernel. 


Serial Plotter Configuration Requirements 


Architecture 

Interface Card 

Interface 
and Device 
Drivers 

Default Device File 

Series 700 

(internal) ^ 

asioO 

/dev/tty#p#’’ 

Series 800 CIO 

98196A‘= 

98190A 

mux0‘^ 

(same as above) 

Series 800 HP-PB 

40299B‘'J2092A 
J2093A J2094A 
J2096A 
A1703-60022 

mux2® 

(same as above) 

Series 800 HP-PB 

A1703-60003 ^ 
28639-60001 

mux4® 

(same as above) 


a. The following model plotters can be configured to the Series 700 serial 
interface; 7440A, 7475A, 7550A, 7558, 7570A, 7576A, 7596C, 
C1620A, C1625A, C1627A, C1629A, C2847A, C2848A, C2858A, 
C2859A, C3170A, C3171A, C3180A, C3181A. 

b. The device file created by default is the standard 
/dev/ttyiastance# pport# . For ease of system administration, 
HP recommends that you create a line-printer device file 
(/dev/c#p#_lp) using mksf, as explained in “Creating a Device 
Special File for a Printer or Plotter Configured to a Serial Port”. The 
device naming convention derives from ioscan output: c# is the card 
instance for the tty class of interface card to which the device is 
attached and p# is the port to which the plotter is attached. 
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c. The following plotter models can be configured to the Series 800 
RS-232-C serial interface: 7440A, 7475A, 7550A/B, 7558, 7586B, 
7595A, 7595B, 7596A, 7596B, 7599A, C1620A, C1625A, C1627A. 
HP plotter models 7595A and 7596A can also be configured to an 
RS-422 interface. 

d. Specifying muxO causes cio_ca0, sio, pfail, and pa to be 
included in the kernel. 

e. Specifying mux2 causes sio, pfail, and pa to be included in the 
kernel. 

f. These cards are typically used for console and remote console. If the 
second port is not being used for remote console, a plotter may be 
attached. 

g. Specifying mux4 causes lanmuxO, lan3, lanttyO, sio, pfail, and 
pa to be included in the kernel. 
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Guidelines for Configuring a Printer or Plotter to a 
Parallel (Centronics) Interface 

Table 7-3 Parallel Printer Configuration Requirements 


Architecture 

Interface 

Card 

Interface and 
Device 

Drivers 

Default Device File 

Series 700 Core 

I/O 

(internal) ^ 

Cent If'’ 

/dev/c#t#d0_lp‘’ 

Series 800 

HP-PB 

28655A 

lpr2® 

(same as above) 


a. The following printer models can be configured to the Series 700 
parallel interface; 2562C, 2563C, 2566C, 2567C, 33449A, 33459A, 

Cl645A, C1656A, C1686A, C2010A, C2011A, C2021A, C2040A, 
C2106A, C2113A, C2114A, C2121A, C2356A 

b. Specifying Cent If causes CharDrv to be included in the kernel. 

c. c#t#d# derives from the hardware path, as shown in ioscan output: 
c# is the card instance for the ext_bus class of interface card to which 
the printer is attached, t# is the target number, d# is the device number. 

d. The following printer models can be configured to the Series 800 
HP-PB parallel interface: 2225C/P, 2227A, 2228A, 2235A, (2276A), 
(2277A), 2562C, (2563A/B/C), (2564B/C), (2565A), (2566B), 2566C, 
(2567B), 2567C, (2684A/P), (2686A/D), 2932A, 2934A, (33438P), 
(33440A), (33447A), 33449A, 33459A, 33471A, 3630A, C1202A, 
C1602A, C2106A. (Obsolete models are shown in parenthesis and are 
listed for reference only.) 

e. Specifying lpr2 causes sio, pfail, and pa to be included in the 
kernel. 


NOTE Neither Series 700 EISA nor Series 800 Cl 0 architectures support a 

parallel interface. 
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Table 7-4 Parallel Plotter Configuration Requirements 


Architecture 

Interface 

Card 

Interface 
and Device 
Drivers 

Default Device File 

Series 700 Core 

I/O 

(internal) ^ 

Cent If'’ 

/dev/c#t#d0_lp'’ 

Series 800 HP-PB 

28655A 

lpr2® 

(same as above) 


a. The following plotter models can be configured to the Series 700 
parallel interface; 7440A, C1631A, C2859A, C1620A, C1633A, 
C3170A, Cl625A, C2847A, C3171A, Cl627A, C2848A, C3180A, 
C1629A, C2858A, C3181A 

b. Specifying Cent If causes CharDrv to be included in the kernel. 

c. c#t#d# derives from the hardware path, as shown in ioscan output; 
c# is the card instance of the ext_bus class of interface card to which 
the plotter is attached, t# is the target number, d# is the device 
number. 

d. The following plotter models can be conhgured to the Series 800 
HP-PB parallel interface; 7550B, C1600A, C1601A, C1620A, 

Cl625A, Cl627A 

e. Specifying lpr2 causes sio, pfail, and pa to be included in the 
kernel. 


NOTE 


Neither Series 700 EISA nor Series 800 Cl 0 architectures support a 
parallel interface. 
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Guidelines for Configuring a Printer to a SCSI 
I nterface 

Table 7-5 SCSI Printer Configuration Requirements 


Architecture 

Interface Card 

Interface 
and Device 
Drivers 

Default Device Files 

Series 800 CIO 

27147-60002 ^ 

scsi2*’ 

IprS*^ 

/dev/c#t#d#_lp‘^ 

Series 800 

HP-PB 

28655A^ 

scsil® 

lpr3® 

(same as above) 


a. The following printer models can be configured to the Series 800 SCSI 
interface: C2001A, C2106A, C2114A, C2753A, C2754A, C2755A, 
C2756A, C2772A, C2773A, C2776A, C2777A 

b. Specifying scsi2 causes cio_caO, sio, pfail, and pa to be 
included in the kernel. 

c. Specifying lpr3 causes target, sio, pfail, and pa to be included 
in the kernel. 

d. c#t#d# derives from the hardware path, as shown in ioscan output: 
c# is the card instance of the ext_bus class of interface card to which 
the printer is attached, t# is the SCSI ID number, d# is the device 
number. 

e. Specifying scsil causes sio, pfail, and pa to be included in the 
kernel. 


NOTE There is no SCSI printer driver for Series 700. Also, SAM does not 

support SCSI printers. 
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Configuring a Printer Using HP-UX 
Commands 

F i rst configure the software for the operati ng system. Then, if necessary, 
bri ng down the system to i nstal I hardware. When you reboot, H P-U X wi 11 
automatically bind the drivers to the peripherals it finds. 

Step 1. Consult the tables in "Selecting Device Drivers for Your Printer or 

Plotter" to identify which drivers need to be present in your kernel for 
HP-UX to communicate through the intended interface with the printer. 

Step 2. Execute /usr/sbin/lsdev -dprir!ter_driv'er to see whether the 

driver is already in the kernel. If it is, you might see output resembling 
the following (shown for a Series 700 parallel interface): 

/usr/sbin/lsdev -d Centif 

Character Block Driver Class 

216 -1 Centif ext_bus 

For a Series 800 parallel interface, executing /usr/sbin/isdev 
-d ipr2 might show similar output, but the character major number is 
181.1 n both Series 700 and 800 systems, the interface class is ext_bus. 

Step 3. Determine how much additional configuration is needed for the printer 
by invoking the command, /usr/sbin/ioscan 
-fn -dprinter_driver. 

< If the necessary drivers are already present in the kernel, the 

ioscan output of a Series 700 might resemble this: 

/usr/sbin/ioscan -fn -d Centif 

Class I H/W Path Driver S/W State H/W Type Description 


ext_bus 1 2/0/6 Centif CLAIMED INTERFACE Built-in Parallel Interface 

/dev/clt0d0_lp 
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Similarly, the ioscan output for a Series 800 might resemble this: 

/usr/sbin/ioscan -fn -d lpr2 

Class I H/W Path Driver S/W State H/W Type Description 


ext_bus 2 56/53 lpr2 CLAIMED INTERFACE HP28655A-Parallel Interface 

/dev/c2t0d0_lp 

Both cases show that the drivers and device special files are present, 
allowing HP-UX to communicate with the printer. 

You can attach your printer without further operating-system 
configuration and without bringing down the system. 

Your next task is to configure the LP spooler, to enable you to send 
print jobs to the printer or plotter. Todoso, see "Managing Printers 
and Printer Output," in Managing Systems and Workgroups. 

• If any necessary static driver is absent from the kernel (for 
example, if configuring the printer also involves adding an interface 
card, or if you are configuri ng the pri nter to an i nterface not 
previously used for a printer), the ioscan output of a Series 800 
might resemble this: 

/usr/sbin/ioscan -fn 

Class I H/W Path Driver S/W State H/W Type Description 


ext_bus -1 56/53 UNCLAIMED UNKNOWN HP28655A-Parallel Interface 

Notice in this example, the Driver field for the parallel interface is 
blank, the class and hardware type are unknown and no device 
special file is displayed. 

If the printer driver is absent, you will need to rebuild the kernel to 
include it. 

Here is how to do so: 

a. Changedirectory to the build environment (/stand/build). 
There, execute a system preparation script, system_prep. 
system_prep writes a system file based on your current kernel in 
the current directory. (That is, it creates /stand/buiid/system.) 
The -V provides verbose explanation as the script executes. 

cd /stand/build 
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/usr/lbin/sysadin/system_prep -v -s system 

b. M odify the /stand/buiid/system file to add the absent dri ver(s) 
by i nvoki ng the kmsYstem command. The -c y specifies that 
driver-name is to be configured into the system. (If you are adding 
an interface card also, make sure to add the interface driver, as 
documented in Chapter 2 , "Configuring I nterface Cards." 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 

description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


c. Build the new kernel by invoking the ink_kernei command. This 
creates /stand/buiid/vinunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the old system file by moving it. Then move the new system 
file into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Prepare for rebooting by invokingthe kmupdate command. This 
sets a flag that tells the system to use the new kernel when it 
restarts. 

/usr/sbin/kmupdate 

f. If your printer installation also requires that you install an E/ISA 
card, you need to run eisa_config at this time to configure the 
EISA or ISA bus. Consult Appendix A , "EISA Board 
Configuration," of this manual for tutorial and procedures and 
eisa_config (IM) in the H P-UX Reference 

Step 4. Once the software configuration is complete, bring down the system with 
sufficient grace period to allow users to exit their files. You can execute 

/usr/sbin/shutdown -r or /usr/sbin/reboot. 

I f you have to i nstal I an i nterface card, bri ng the system to a complete 

halt (that is, use /usr/sbin/shutdown -h or /usr/sbin/reboot -h). 
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See shutdown (IM) or reboot (IM) in the HP-UX Reference 

a. Power off and unplug all peripherals, then the SPU. 

b. I nstal I the hardware, as descri bed I n the manual accompany! ng the 
(card and) printer. 

c. Connect the printer to the card. 

d. Plug in and power up the printer. 

e. Set the hardware switches for the pri nter address. 

f. Plug in and power on any other peripherals and then the SPU. 

When the system reboots from the new kernel, H P-UX detects the 
printer and associates it with its driver. 

In most instances, insf automatically creates the device special files 
necessary to communicate with the printer, although in some cases you 
will need to create the device special files as a separate operation. (Two 
cases — configuring a printer to a serial port and guidelines for 
configuring a non-H P printer to a parallel port — are documented 
following this procedure.) Also refer to Appendix C , "Major and Minor 
Numbers," for instructions on using mknod to create a custom device 
special file, if needed. 

steps. I nvoke /usr/sbin/ioscan -fn -d printer_driver agai n tO Confirm 
that the I/O subsystem finds the printer and has created the necessary 
device special files. Your output should now resemblethat shown in step 
3. 

Your next task is to configure the LP spooler to enable you to send print 
jobs tothe printer or plotter. See "Managing Printers and Printer 
Output," in Managing Systems and Workgroups. 

Creating a Device Special File for a Printer or Plotter 
Configured to a Serial Port 

By default, insf creates device special files for parallel and SCSI ports 
that can be easily associated with a printer or plotter. 

However, the device special files insf creates for serial ports (ports 
controlled by asioO, muxO, mux2, and mux4) are named to accommodate 
terminals more intuitively than printers or plotters. To use the serial 
port for a line printer, you should create a new device special file with a 
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line printer name. 

Step 1. Execute ioscan -fn -c tty to identify the device file currently 

associated with the port. Note in the following excerpted output, the 
sample device special file representing port 3 has a name consistent with 
the device-file format used by terminals and modems. 

/usr/sbin/ioscan -fn -C tty 

Class I H/W Path Driver S/W State H/W Type Description 


tty 0 56/56 mux2 CLAIMED INTERFACE MUX 

/dev/tty0p3 

Step 2. Create a new device special for the port to which you are attaching the 
printer by invoking /usr/sbin/mksf and specifying the device driver 
(-d), hardware path (-h), and serial port (-p). Use -i to create a device 
special file with a line-printer name and -vfor verbose output. 

For example, thefollowing command linecreatesa new device special file 
for port 3 with a line-printer name. 

/usr/sbin/mksf -d mux2 -H 56/56 -p3 -1 -v 

making c0p3_lp c 193 0x000300 

If your manual states that your printer uses hardware flow control 
(RTS/CTS) and you wish to employ it, you can execute mksf with the -f 
option to enable the feature. 

/usr/sbin/mksf -d mux2 -H 56/56 -p3 -f -1 -v 

making c0p3_lp c 193 0x000310 

Step 3. Invoke /sbin/ioscan -fn again to display the new device special file, 
whose name will now be consistent with other line printer device special 
files. 

Class I H/W Path Driver S/W State H/W Type Description 


tty 0 56/56 mux2 CLAIMED INTERFACE MUX 

/dev/c0p3_lp 


You can also confirm the file's characteristics by invoking 
/usr/sbin/issf on the new file or viewing the long listing (ii). 


176 


Chapter? 







Configuring Printers and Piotters 

Configuring a Printer Using HP-UX Commands 


/usr/sbin/lssf /ciev/c0p3_lp 

mux2 card instance 0 port 3 hardwired at address 56/56 /dev/c0p3_lp 

11 /dev/c0p3_lp 

crw-rw-rw- 1 bin bin 193 0x000300 Mar 16 18:29 /dev/c0p3_lp 

I n the minor number (0x000300, shown in the long listing), you can see 

that the 3 corresponds to the port number for themux2 card at card 
instanceO. 

If you have enabled hardware flow control, your output will resemble the 
following: 

/usr/sbin/lssf /ciev/c0p3_lp 

mux2 card instance 0 port 3 hardwired HW flow control 
at address 56/56 /dev/c0p3_lp 

11 /dev/c0p3_lp 

crw-rw-rw- 1 bin bin 193 0x000310 Mar 16 18:29 /dev/c0p3_lp 

I n the minor number (0x0003i0, shown in the long listing), you can see 

that the 3 corresponds to the port number for themux2 card at card 
instanceO and that bit 27 is set. (For minor number bit assignments, see 
AppendixC , "Major and Minor Numbers.") 

Your next task will be to configure the LP spooler to enable you to send 
print jobs to the printer or plotter. See "Managing Printers and Printer 
Output," in Managing Systems and Workgroups. 

Guidelines for Configuring a Non-HP Printer to a 
Parallel Port 

Compatibility problems typical when configuring non-HP peripherals to 
the parallel interface usually involvethe handshake mode. The centif 
driver provides six handshake modes that can be accessed for different 
implementations. To usethem, create a custom device special file using 
specific bits in the minor number. 

When a peripheral is unableto communicate via the parallel port, be 
sure to use the cat command and not ip as a starting point. This 
eliminates problems with model scripts and ipsched. If this fails, and 
the peripheral is known to work, substitute an H P Laserj et or DeskJ et 
printer and test again. If the H P product works, the problem may be in 
the handshake method. (Be sure that the problem is communication and 
not the text going to the printer — a PostScript printer will always report 
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an error if an ASCI I file is sent to it.) 

TableC-3, "Minor Number for a SCSI Disk Device,"shows the the bit 
assignments for the centif driver. Bits 28-31 encode the handshake 
mode, as follows: 

1 Handshake using nACK and BUSY lines. 

2 Handshakeusing BUSY lineonly. 

3 Bidirectional read/writefor ScanJ et support. 

4 Streaming mode. Setup =1 usee, hold =1 usee. This 
mode is commonly used by Tektronix (Phaser and 
others) printers. 

5 Pulsed mode. Similar to mode 1, but nSTROBE is 1 
usee. 

6 Pulsed mode. Similar to mode 2, but nSTROBE is 1 
usee. 

Modes 5 and 6 are used to resolve deadlock situations that may occur in 
modes 1 and 2. Products that work well with modes 5 and 6 are the H P 
293xfamily of printers, and some printers from NEC and Qume. 

Note, these modes are for reference use only. Nosupport (beyond mode2 
for H P Laser] ets) is i mpl ied; however, the user may test these modes for 
possible success with other vendor devices. For more information on the 
Centronics interface, consult the cent (7) manpage. 
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Configuring a Plotter or other 
Non-Automatically Configurable Output 
Devices Using HP-UX Commands 


NOTE Although this procedure refers explicitly to plotters, it can be used to 

configure other devices that need the instrO device driver on a Series 
800 computer. 


Unlike printers, plotters cannot be automatically configured by the 
kernel. I nstead, you must manually ensurethat the driver is associated 
with the hardware path by using the capabilities of ioscan. 

Step 1. Connect your plotter, noting the hardware address to which you are 

connecting it and the H P-l B address to which you are setting the plotter. 
I n this example, we are configuring an H P 7596A Draftmaster II to an 
HP-1 B interface located in card-cage slot 12 in a Model 806 computer. 
The H P-l B address is set to 5. 

Step 2. Identify the hardware path to the plotter by invoking ioscan. An excerpt 
of the output might resemble the foil owing: 

/usr/sbin/ioscan -f 

Class I H/W Path Driver S/W State H/W Type Description 


be 0 

be 1 56 

lanmux 0 56/44 

Ian 1 56/44.1 


root 

be 

lanmuxO 

lan3 


CLAIMED BUS_NEXUS 

CLAIMED BUS_NEXUS Bus Converter 

CLAIMED INTERFACE HP J2146A - 802.3 LAN 

CLAIMED INTERFACE 


The interface driver is hpibi and the hardware path of interface card to 
which the plotter is connected is 56/48 (hardware path equals slot 
number times four; the bus converter is in slot 14, the interface card is in 
slot 12). Neither the H P-l B address of the plotter nor the instrO device 
driver is shown. 


Step 3. Rebuild the kernel to include the instrO driver. Here is how to do so: 


a. Change directory to the build environment (/stand/build). There, 
execute a system preparation script, system_prep, which extracts the 
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system file from the cur rent kernel and writes a system file in your 
current directory. (That is, it creates /stand/buiid/system.) The -v 
provides verbose explanation as the scri pt executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

b. Modify the/stand/build/system fileto add the absent driver(s) by 
i nvoki ng the kmsystem command. The -c y specifies that 
driver-name is to be configured into the system. 

/usr/sbin/kmsystem -S /stand/build/system -c Y driver-name 


NOTE To avoid introducing format errors, do not edit the HP-UX system 

description files directly. Instead, use the commands kmsystem and 
kmtune. These commands are new for Release 11.0; consult kmsystem 
(IM) and kmtune(IM) in the HP-UX Reference 


c. Build the new kernel by invoking the mk_kernei command. This 
creates /stand/buiid/vmunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s /stand/build/system 

d. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

e. Preparefor rebootingby invoking the kmupdate command. This sets a 
flag that tells the system to use the new kernel when it restarts. 

/usr/sbin/kmupdate 

Step 4. Reboot the system by invoking the shutdown command with sufficient 
grace period to al low users to exit thei r files before the system goes down. 
See shutdown (IM) in the HP-UX Rd'erence 

Step 5. Bind the software driver used by the plotter (instrO) to the plotter's full 
hardware path (56/48.5) by executing /usr/sbin/ioscan with the -m 
and -H options. Then verify the results by executing ioscan again. 

As shown in the following sequence of commands and ioscan output, the 
device driver (instrO) associates with a peripheral device at address 
56/48.5. The instrO driver cannot identify any more specifically what 
instrument is attached, but it can communicate with it. 
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/usr/sbin/ioscan -M instrO -H 56/48.5 
/usr/sbin/ioscan -kf 


Class 

I 

H/W Path 

Driver 

S/W State 

H/W Type 

Description 

be 

0 


root 

CLAIMED 

BUS_NEXUS 


be 

1 

56 

be 

CLAIMED 

BUS_NEXUS 

Bus Converter 

lanmux 

0 

56/44 

lanmux0 

CLAIMED 

INTERFACE 

HP J2146A - 802 

Ian 

1 

56/44.1 

lan3 

CLAIMED 

INTERFACE 



Step 6. Create a device special filefor the plotter by invoking /usr/sbin/insf 
with the -H (hardware path) option; for example: 

/usr/sbin/insf -H 56/48.5 

This installs the device special filefor the hardware path and instrO. 
You can verify this by executing ioscan -h 56/48.5 -fn to see the file 
name and then issf filename to see the device file's attributes. 

Your next step will be to configure the LP spooler to enable you to send 
print jobs to the plotter; for procedure, see "Managing Printers and 
Printer Output" of the Managing Systems and Workgroups manual. 
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Moving a Printer or Plotter 

To move a printer or plotter, first remove it and then add it to your 
configuration. This sample procedure demonstrates attaching a printer 
to a different interface card. 

Step 1. Notify users that you are moving the printer or plotter. 

Step 2. If you have customized it, copy the /etc/lp/interf ace/printer_name 
to a temporary location. 

cp /etc/lp/interface/laserjet /etc/lp/interface/laserjet_old 

Step 3. Remove the printer or plotter from the LP spooler by following the 
procedurefor "Removing a Printer or Printer Class using HP-UX 
Commands" detailed in the chapter, "Managing Printers and Printer 
Output" of the Managing Systems and Workgroups manual. 

Step 4. Execute /usr/sbin/ioscan to identify the printer or plotter's hardware 
address, which you are going to change. 

Step 5. Turn off, unplug, and disconnect the printer or plotter. 

Step 6. Reset the switches on the printer or plotter, if necessary, and attach the 
device to the new hardware location. 

Step 7. Execute ioscan again, ioscan reports the new address and indicates 

under s/w state that no hardware is present at the old printer address. 

HP-UX automatically creates a device file to access the printer except: 

• If you areconfiguring a printer toa serial port: Create the device 
special file by following the instructions in the section "Creating a 
Device Special Filefor a Printer or Plotter Configured to a Serial 
Port". 

• If you are configuring a plotter: Force H P-UX to recognize the plotter 
at the new address by following the instructions in "Configuring a 
Plotter or other Non-Automatically Configurable Output Devices 

U si ng H P-U X Commands". 

Next, configure the LP spooler to recognize the printer or plotter at its 
new location by consulting the chapter, "Managing Printers and Printer 
Output" in the Managing Systems and Workgroups manual. 
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For Further Information on Printer-Related 
Tasks 


Managing Systems and Workgroups, "Managing Printers and Printer 
Output," to set up the LP spooler. 

SharedPrint/ UX User and Administrator's Guide 

HP MPower 1.2 Installation and Configuration 

H P J etDirect Network I nterfaceConfiguration Guide 

HP OpenView OpenSpool documentation 

The following manpages in the HP-UX Rd'erence: 

enable(1), disable(1) Enableor disable LP printers 

Ip (1) Send, cancel, or alter LP requests 

Ipstat (1) Print LP status information 

pr (1) Print files 

sip (1) Set printing options for non-serial printer 

accept (IM), rqect (IM) Allow or prevent LP requests 

bootpd (IM) I nternet boot protocol server 

eisa_config (IM) EISA configuration tool 

insf(lM) Install special files 

ioscan (IM) Scan I/O system 

Ipadmin (IM) Configure the LP spooling system 

Ipana (IM) Print LP spooler performance analysis information 

Ipsched (IM), Ipshut (IM) Start or stop LP request scheduler 

mk_kernel (IM) Build a bootableHP-UX kernel 

rcancel (IM) Remove requests from LP queue 

rl p (IM) Send requests to a remote system 

rlpdaemon (IM) Remote spooling LP daemon 

ripstat (IM) Print status of remote LP spooler requests 
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shutdown (IM) Terminate all processing 

tsm.lpadmin (IM) Manage printers using Terminal Session Manager 
x29printd (IM) Remote PAD printer server for LP requests 


dp (4) 

pcf (4) 

cent (7) 

Dedicated ports file, used by DDFA and DTC 

Port configuration file, used by DDFA software 

Parallel (centronics) interface 

ddfa (7) 

DTC device file access software 

Ip (7) 

Line printer 
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For Further Information on Plotter-Related 
Tasks 

• Starbase Graphics Techniques 

• SharedPrint/ UX User and Administrator's Guide 

• Managing Switchover/ UX 

• I n addition to the manpages listed in the previous section, the 
following manpages may be helpful: 

Ipfilter (IM) (piotdvr) HP-GL plotter filter 
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Configuring Uninterruptibie 
Power Systems 


I nstalling a PowerTrust Uninterruptible Power System (UPS) to an 
HP-UX computer ensures that power is maintained to your computer 
system for up to fifteen minutes after an AC power failure, preventing 
problems such as networking timeouts and tape rewinds. 

The PowerT rust U PS can be configured to bring the system down with a 
graceful shutdown before its batteries deplete, thus maintaining data 
integrity and ensuring a clean reboot and reasonable systemwide fsck. 

PowerT rust UPS is configured as a serial device. This chapter details the 
configuration guidelines. 
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Planning to Configure a UPS 

Hardware Considerations 

Choose your UPS based on its rated load capabilities. 

Determine which pieces of hardware besides the server require coverage 
by a U PS. For example, 

• If users in another building rely on the server, or several servers in a 
building require LAN traffic to shut down cleanly, you might need to 
ensure that the LAN interface is protected by the UPS. 

• If you need to cal I in to the UPS-based servers, the dial back and DTC 
to which it is attached may need to be on the U PS. 

Calculate the voltage/amperage (VA) capacity to ensure that your UPS 
unit is properly rated for the expected load. Detailed instructions for 
calculating how many systems and/or devices can be powered by an H P 
PowerTrust UPS are found in the HP Configuration Guide. 

When adding disks or other peripherals to any computer covered by a 
UPS, recalculate the voltage/amperage (VA) load to ensure that the new 
current draw remains within the UPS coverage. 

Prepare the site before installing the UPS, following the 
recommendations provided in the UPS hardware installation manual 
and PowerTrust SystemGuide(H P part number 5961-8383)for your UPS 
model. 

Figure 8-1, "SampleConfiguration of an Uninterruptible Power System 
(UPS)," illustrates a sample UPS configuration. (Note, the RS-232-C 
cabling from the consoletoSPU is not shown.) All protected components 
derive their electrical power through the UPS, which is plugged into the 
power source. 

Sample Configuration of an Uninterruptible Power System 
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(UPS) 



Cabling Guidelines 

To communicate with the host, each PowerTrust U PS comes with an 
RS-232-C seriai connector, HP part number 5061-2569 (pinoutsshown in 
Tabie8-1, "UPS Cabie Pin-Outs.")Thecabie has a maieDB-9connector 
on the UPS end and a maie DB-25 connector on the MUX end, and is 2 
meters (6.5 feet) iong. if this iength is insufficient, you can extend it by 
using a straight-through 25-wire RS-232-C extender cabie (3062C, 25 
feet iong) from the MUX port to the DB-25 connector end of the cabie 
suppiied with the UPS, and then the UPS cabie to the DB-9 connector of 
the UPS. Totai RS-232-C cabie iength shouid be no more than ten meters 
maxi mum. 
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NOTE Do not use a standard terminal cable to connect a UPS to the serial port. 

The pi nouts are different. 


Table 8-1 UPS Cable Pin-Outs 



UPS 

MUX 


9 pins(M) 

25 pins(M) 

Receive 

1 

3 

Transmit 

2 

2 

Gnd 

9 

7 


The computer should have one dedicated MUX port for U PS 
communication for each UPS configured. Additional UPS units must be 
connected to additional dedicated MUX ports. 

Hewlett Packard supports only 25-pin MUX ports for UPS operation. The 
modem port on the MFIO (Console LAN pea), RJ 45, 3-pin RS-232 and 
5-pin RS-422 MUX ports are not supported for UPS operation. 

For each UPS on the system, you are connecting the supplied RS-232-C 
cable from the UPS to a port on a Modem Distribution Panel (MDP). The 
computer console must be configured to port 0. You can connect the U PS 
to port 1 on the MDP. 

Software Considerations 

Be sure that you have loaded the PowerT rust UPS fileset, ups-tools. 
You can do this using the swinstaii command. Consult the H P 
Open View Software Distributor Administrator's Guidefor procedures on 
loading fi I esets. 

Note, since the connections totheUPS arethrough power cords and 
MUX ports, ioscan will not explicitly display a UPS in its configuration; 
only the MUX port is displayed. 
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Table 8-2 


Selecting Drivers for a UPS 

Uninterruptable power systems usea serial interface and multiplexer 
drivers. Table 8-2, "UPS Configuration Requirements," shows the 
interfaces, device drivers, and device special files used for each supported 
architecture. 


UPS Configuration Requirements 


Architecture 

Interface 

Card 

Driver 

Default Device 
Special Files 

Series 800 HP-PB 

40299B 

J2092A 

J2093A 

J2094A 

J2096A 

A1703-60022 

mux2'’ 

/dev/mux# 

/dev/tty#p#‘^ 


a. HP-UX supports the following HP PowerTrust UPS models: 
A2941A, A2994A, A2996A, A2997A, A2998A. The following 
third-party UPS models can be used with HP computers, but do not 
provide the software capabilities of HP PowerTrust models: 
APPCC-600UX, APPCC-1250UX, DELT-2326/C2, DELT-2336/C2. 
Not all supported models are appropriate for all computer systems. 

b. Specifying mux2 causes sio, pfail, and pa to be included in the 
kernel. 

c. ttyttp# derives from ioscan output: The numeral after tty is the 
card instance for the tty class of interface card to which the device 
is attached; the numeral after p is the port number of the serial 
interface. 
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Configuring a PowerTrust UPS 

The simplest way to configure a uninterruptable power system is to use 
SAM (/usr/sbin/sam). If SAM is not loaded on your system or if you 
prefer to use the command-line interface, the following procedure will 
guide you through the task. Familiarize yourself with the instructions 
before getti ng started. 

Step 1. ExamineTable 8-2, "UPS Configuration Requirements," to identify the 
driver and i nterface card associated with the specific platform to which 
you are configuring the UPS. Under virtually all circumstances, the 
interface driver used by the UPS is already present in the kernel. 

Step 2. I nvoke ioscan for the tty class to display the hardware path, driver, and 
device special file(s) available for the UPS. Your output might resemble 
the foil owing: 

/usr/sbin/ioscan -fun -C tty 

Class I H/W Path Driver S/W State H/W Type Description 


tty 0 56.0 mux4 CLAIMED INTERFACE 

/dev/ttyOpO /dev/ttyOpl 

I n this (simplified) example from a Model 887, the multiplexer card is 
installed in slot 14 (h/w Path divided by 4) and bound with themux4 
device driver. Device special files /dev/ttyOpO and /dev/ttyOpi are 
available. If an MDP or DDP is installed at the MUX port, ioscan will 
show device special files for all the ports available. 

Asshipped, the console is configured to be plugged in at port o. The 
/dev/console file is equivalent to /dev/ttyOpO. Thus, in this example. 
Port 1 (represented by /dev/ttyOpi) can be used for the UPS. 

Step 3. Edit the /etc/inittab file to activate the UPS monitoring daemon when 
the system boots up. To do so, 

a. Remove the comment sign (#) from the U PS entry. Be sure the ups 
entry appears after the /sbin/rc entry, so that the ups_mond is 
started after the system logging daemon (sysiogd). Note, the UPS is 
started with real-time priority so that it does not get "starved" on a 
busy system. 

ups :respawn:rtprio 0 /usr/lbin/ups_mond -f /etc/ups_conf 
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b. Add a comment sign (#) in front of thegetty entry corresponding to 
the port used by the U PS. For example, 

#ttpl:2:respawn:/usr/sbin/getty -h ttyOpl 9600 

Step 4. Edit the /etc/ups_conf file to customize the UPS configuration for your 
system. The etc/ups_conf file informs the monitoring daemon 
(/usr/ibin/ups_mond) which ports to monitor and how to react to U PS 
status. The ups_conf (4) manpage documents the required format and 
available options. Also, read carefully the guidelines for setting 
shutdown options just ahead. 

shutdown_delaY_rains:1 
shutdown_timeout_mins:5 
upstty:/dev/ttyOp1 
upstty:/dev/tty0p2:MSG_ONLY 

a. ToensurethattheUPSoperatesappropriatelytoyoursystem, review 
carefully the guidelines listed below concerning how to set 

shutdown_delay_mins and shutdown_timeout_mins in the 
/ etc/ups_conf file: 

• shutdown_deiay_mins (one minute, by default) is the number of 
minutes after loss of AC power is detected before H P-UX invokes 
shutdown -h. I ncrease this value if the site commonly experiences 
momentary power interruptions greater than one minute for 
which recovery of power is expected. 

• On a large system, do not set the shutdown_deiay_mins to a value 
larger than nine minutes. H P guarantees the UPS to provide 
output power for upto fifteen minutes. Large systems may takeas 
long as five minutes to complete shutdown pluxone minute for the 
shutdown grace period. Thus, to ensure that the U PS provides 
power for the entire operation, figure maximum 
shutdown_deiay_mins as fifteen minus six, or a difference of nine 
minutes. 

• shutdown_timeout_mins (five minutes, by default) is the number 
of minutes shutdown -h is expected to take. UPS terminates 
power supply one minute after this value elapses. I f shutdown 
does not complete in the time specified, the UPS monitor initiates 
a reboot -h to halt the system. 

• I ncrease shutdown_timeout_mins if shutdown takes longer than 
five minutes, including the one minute grace period. 
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• Decrease shutdown_timeout_mins if shutdown takes less than 
five minutes. Small systems can take advantage of this. 


CAUTION You must wait the full duration of shutdown_timeout_mins before 

cycling power to the SPU, regardless of whether AC power has been 
restored. Once activated, the UPS will turn off after that period of time. 


If you are configuring more than one UPS, list their device special 
files on separate lines in priority order. Make sure the most important 
UPS (that is, for the SPUs) is the first one listed. 

b. If a UPS governs peripheral devicesand external bus extenders, it 
should be configured to send and log messages, but not to initiate a 
system shutdown. To use this option, set upstty for that UPS to 
MSG_ONLY. (I f you are using SAM, msg_only is referred to as 
noncritical operation.) 

c. Print a copy of your /etc/ups_conf file so that you can refer to it 
when cabling the UPS hardware. You will want to verify that the 
device special file associated with upstty matches that used by the 
UPS. For example, upstty:/dev/ttyOpi specifies that the UPS is 
plugged into the second port (pi) of an RS-232 MDP connected to an 
interface card at card instance o. 

Step 5. Bring the system down to a halt (shutdown -h), then turn power off. 

I nstall the UPS hardware, following instructions provided in the 
hardware documentation. Also see the cabling information provided in 
"Cabling Guidelines", earlier in this chapter. 

Step 6. Power up the peripherals, PowerTrust, then SPU. On rebooting, HP-UX 
will configure all connected components. Everything connected to the 
UPS will be protected against sudden power failure. 
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Configuring UPS to Cycle Power During 
Non-Work Hours 

In work environments where energy savings is crucial, you can use your 
UPS to cycle power on and off according to a specified schedule. You can 
set this up with two commands: I nstruct cron to implement the 
power_onoff command, unattended, as part of a routine schedule. 
Consult the cron (IM) and >power_onoff (IM) manpagesfor information 
on using this feature. 

The following procedure causes the system to shut down at 5:30pm and 
start up at 7:30am each weekday. Saturday and Sunday, the system 
remains powered off. 

Step 1. Create a crontab file containing the following entries. The first entry 
applies to Monday through Thursday and the second entry applies to 
Friday. 

30 17 * * 1-4 power_onoff 7:30 tomorrow 
30 17 * * 5 power_onoff 7:30 Monday 

This tells cron to execute power_onoff at 5:30pm Monday through 
Friday. power_onoff executes shutdown -h 60 immediately. The 
arguments to power_onoff tell ups_mond when to cycle power back on. 

You can specify an increment topower_onoff of up to four days (99.9 
hours) in advance. 

Step 2. Once running, ups_mond logs status messages using sysiogd, the system 
logging daemon. You can configure sysiogd to redirect these messages 
where appropriate. Refer to the sysiogd (IM) manpagefor details. 

For example, you can add these lines to /etc/sysiog.conf: 

# Log/report messages from the ups_mond 


daemon.info 
daemon.err 
daemon.emerg 
daemon.emerg 


/usr/adm/daemon_log 
/usr/adm/daemon_log 
/dev/console 
hostname 


# Log messages from power_onoff 


user.err /usr/adm/user_log 
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Once these lines are added to /etc/sysiog.conf, sysiogd must beset 
to accept the changes. Execute kill -hup 'cat /etc/sysiog.pid' and 
restart ups_mond. 

Step 3. Verify that HP-UX has been properly configured for the PowerTrust UPS 
as follows: 

• Check to makesurethe UPS monitor daemon, ups_mond is running, 
byexecutingps -ef | grep ups. This process is started at bootup by 
/etc/inittab and can be manually started by executing 

/usr/lbin/ups_mond -f /etc/ups_conf. 

• Make sure that the UPS messages are displayed on the console. 

• Check for UPS messages in /usr/adm/sysiog or the files to which 
they are redirected. 

Although the PowerTrust UPS is hardware, it displays in ioscan output 
only as a terminal port. Its monitoring daemon, ups_mond, is a program 
that reads and writes through that port. 
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After Configuring the PowerTrust UPS 

If adding any card or peripheral to a unit monitored by a UPS, you need 
to recalculate the voltage/amperage (VA) draw. 

Regardless of how many PowerTrust UPS devices are installed, only one 
instanceof theups_mond daemon should be running at anytime. 

If you are running SupportWatch, you should include /usr/adm/sysiog 
among those files it monitors, in addition to /usr/bin/dmesg and 

/usr/adm/diag. 

A special circumstance should be noted for systems with external bus 
extenders covered by a PowerT rust UPS. I f for any reason, a disk i n an 
external bus extender loses power buttheSPU to which it is configured 
does not, you must wait the length of time for shutdown_timeout_mins 
before cycling power to the SPU. 

Troubleshooting the UPS 

E rror messages generated by the UPS are documented on the ups_mond 
(IM) manpage. 
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EISA Board Configuration 


Before you can make use of EISA and ISA I/O boards on 
Hewlett-Packard workstations, you must configure them using the 
/sbin/eisa_config program. eisa_config allocates resources (such as 
interrupt lines, memory, and DMA channels) to all the boards on the 
E/I SA backplane, by reading the boards' corresponding cfg files. 

Depending on the type of board, you run eisa_config in one of two 
modes: 

• automatic mode, which executes automatically each time you 
reboot the system. EISA boards can usually be configured 
automatically. 

• interactive mode, which you can execute from the command line. 
ISA boards require that you run eisa_config in interactive mode. 

This appendix covers 

• A sample eisa_conf ig session to add an E/I SA board. 

• Procedures for moving and removing an E/I SA board, as well as 
changing choices for board functions. 

• Troubleshooting E/I SA board configuration problems. 

For further discussion of E/ISA specifications, seeeisa_config (IM) in the 
HP-UX Reference If you are configuring a custom driver or writing your 
own device driver, refer to HP-UX Driver Development Guide (part 
number 98577-90001) and HP-UX Driver Development Reference (part 
number 98577-90602). 
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E/ISA Boards and CFG Files 

ISA boards have physical switches or jumpers for setting the board's 
characteristics. Set the switches and jumpers using documentation 
provided by the board manufacturer, and alter the settings if 
eisa_config reports conflict. 

EISA boards lack physical switches or jumpers but instead use a 
configuration (cfg) file provided by the manufacturer to specify board 
resources. 

The eisa_config program requires a cfg filefor every I SA and El SA 
board, to allocate resources throughout the E/I SA bus. The cfg file 
enables eisa_config to assess all E/ISA resources, and in the case of an 
EISA board, configure it automatically. Although it cannot configure an 
ISA board automatically, eisa_configcan report likelyswitch orjumper 
settings for conflict-free configuration. (Note, however, that some 
configurations a re simply not possible, as when two boards from different 
manufacturers require the same resource. If this happens, only one of the 
boards can be used.) 

E ach board connected to the workstation on the E/I SA bus must have a 
CFG file present in the /sbin/iib/eisa directory. These files are read by 
/sbin/bcheckrc each time you reboot the system. 

CFG files are named with the following syntax: 

rXXXnnnN .CFG 

where: 

r is either ! or a hexadecimal digit. 

XXX abbreviates the board manufacturer's name. 

nnn represents the product ID. 

N represents the revision level. 

The following example shows an excerpted El SA configuration file 
named !hwpoc80.cfg, which contains blocks of board-specific 
information, functions, and choices within the functions. The 
eisa_config program selects a choice for each function. If the first 
(default) choice conflicts with that of another board on the bus, 
eisa_config selects another choice, or suggests switch settings to 
resolve the conflict. 
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BOARD 

ID = "HWP0C80" 

NAME = "HP EISA SCSI host adapter 25525A" 

MFR = "Hewlett-Packard Co." 

lOCHECK = INVALID 
DISABLE = SUPPORTED 

COMMENTS = " This init file performs the following 

- Sets the ABRT to 1 in 0zC85. 

- Sets the RIEN to 0 in 0zC85. 


FUNCTION = "BOOT ROM ENABLE/RELOCATTON" 

CHOICE = "ENABLED" 

LINK 

MEMORY = 32K 

ADDRESS = 0D8000h | 0C8000h | ODOOOOh 
MEMTYPE = OTH 
WRITABLE = NO 

INIT = lOPORT(6)LOC(7-6) 00 | 10 | 01 
CHOTCE = "DISABLED" 

FREE 

INIT = lOPORT(6)LOC(7-6) II 
FUNCTION = "Host Adapter SCSI ID Selection" 

CHOICE = "SCSI ID = 7" 

FREE 

INIT = IOPORT(7) 10000000 
CHOICE = "SCSI ID = 6" 

FREE 

INIT = IOPORT(7) 01000000 

If the default function must be changed, refer to "Changing Choices for 
Board Functions" later in this appendix for selecting a board function. 

/sbin/eisa_config writes its configuration to non-volatile memory 
(N VM) and to a system, sci file, which can be used to create identical 
configurations. For the procedure, see "Creating Identical E/ISA 
Configurations on Other Workstations", later in this appendix. 
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Configuring the Software Required by the 
E/ISA Board 

You install an E/ISA interface board much like installing any other 
board, by following the procedures detailed in Chapter 2 , "Configuring 
Interface Cards." 

However, several additional software elements need to be present for 
proper configuration: 

• A CFG file must reside in the /sbin/iib/eisa directory for every 
EISA board. 

• The eisa interface driver must be part of the kernel before you can 
run eisa_config for all (HP and other) E/ISA boards. 

If you are configuring a board by a different manufacturer, the 
manufacturer must provide a device driver for the board, information for 
acFGfile, and any additional information required to create valid device 
files. 

I n addition to the eisa driver, the interface driver used by the specific 
card (such as SCSI or LAN) must also be part of the kernel. If you are 
connecting a peripheral device (such as a printer or tape drive) to the 
card, the peripheral's device driver must be part of the kernel. The 
interface and device drivers can be added at the same time, thus 
enabling you to regenerate the kernel and reboot your system only once. 

In the simplest case, when you reboot, eisa_config runs and 
automatically configures your E/I SA cards, based on the switch settings 
or information it finds in the cfg files. 

In more complex cases, eisa_config runs and discovers configuration 
conflicts, requiring you to set switches and jumpers on the board, or to 
run the command in interactive mode to resol vet he conflicts. (See 
sections further in this chapter and eisa_config (IM) in the H P-UX 
Reference, and the on-line help within the eisa_config program.) 
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Configuring E/ISA Boards Using Interactive 
Mode 

You might need to run eisa_config interactively for the following 
reasons: 

• You need to add, remove, or move an ISA board, which do not have 
readable ID registers and thus are not automatically recognized by 

eisa_config. 

• eisa_config exited from automatic mode with an error message 
requiring you to change the choice for a function. See "Changing 
Choices for Board Functions" shortly. 

• You want to change the choice that eisa_config automatically 
selected for a function. 

• eisa_config exited from automatic mode with an error message 
requiring you to add a board interactively. 

• You might want to view your E/I SA configuration for planning 
purposes. 


NOTE Always run eisa_config interactively bd'ore physically changing the 

configuration. 


Sample I nteractive Session to Add an E/I SA Card 

starting eisaconfig 

I nvoke eisa_config, which begins by displaying the current board 
configuration. 

/sbin/eisa_config 

HP-UX E/ISA CONFIGURATION UTILITY 

Type q or quit to leave eisa_config. 

Type ? or help for help on eisa_config commands. 
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Slot CFG File Contents 


0 

!HWPCOlO 

HP 

1 

1XYZ1401 

XYZ 

2 


•k k 

3 

1XYZ1702 

XYZ 

4 


ik k 


Series 700 EISA System Board 
SCSI Controller 
EMPTY 

Centronics Interface 
EMPTY ** 


On-Line Help 

Note that eisa_config has self-explanatory on-line help. Type ? or help 
at an eisa prompt and read the entries to acquaint yourself with the 
program. 


Displaying CFG Files 

Type the cfgfiies command to display the cfg files currently in the 
/sbin/iib/eisa directory. The cfgtypes command lists and explains 
each board type. For example, net is a network board. 

EISA: cfgfiies 


Filename 

Board 

!HWPCOlO 

SYS 

!XYZ1401 

MSD 

!XYZ1702 

PAR 

!XYZ1802 

NET 

!XYZ2276 

VID 


Type 


Board Name 

HP Series 700 EISA System Board 

XYZ SCSI Controller 

XYZ Centronics Interface 

XYZ Networking Board 

XYZ Video Board 


Adding a Board 

Make sure the CFG file is present in the /sbin/iib/eisa directory. If it is 
absent, check the documentation supplied with the card, (cfg files are 
requi red for EISA cards, but advisory only for ISA cards.) 

Typea show slot command to see in which slots the !xyzi 802 board 
can be installed. Then type the add command to add the board to slot 2. 
eisa_config displays the new configuration. 

EISA: show slot 1XYZ1802 


Valid slots for this board: 2 4 

EISA: add IXYZ1802 2 

Added board: XYZ Networking Board 

Comments: The XYZ Networking board is an IEEE 802.3 local 
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area networking 


board for use with twisted-pair cabling. 


Slot 


CFG File 


Contents 


0 

1 

2 

3 

4 


!HWPCOlO 
1XYZ1401 
1XYZ1802 
1XYZ1702 


HP Series 700 EISA System Board 
XYZ SCSI Controller 
XYZ Networking Board 
XYZ Centronics Interface 
** EMPTY ** 


You can usethe comment command to display help or comments provided 
by the manufacturer about the board and its switches, the interface 
functions and choices. 

Correcting a Mistake Whiie Using eisa config 

If you have made changes in the configuration that you want to undo, 
you can return to the current session's initial configuration by using the 
init command. 

Type the foil owing command: 

[init [system.sci ]] 

If you specify system.sci, eisa_config retrieves the Configuration from 
that file; otherwise, it retrieves it from non-volatile memory (N VM). 

Dispiaying Board Information 

Type a show command to ask for information on the board in slot 2. 
eisa_config displays the board's basic attributes and indicates the 
currently selected choice for each function. 

EISA: show board 2 

XYZ Networking Board 
CFG file: 1XYZ1802.CFG 
Slot 2 

The XYZ Networking board is an IEEE 802.3 local area 
networking board for 

use with twisted-pair cabling. 

Manufacturer . XYZ Computer Corp. 

ID . XYZ1802 

Board type . NET (Network Board) 

Board slot type . ISA 8 Bit 

Readable ID . No 
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Skirt . No 

Length . 330 millimeters 


Function names and possible choices: 

StarLAN 10 PC LAN Adapter 
FI: I/O Base Address 

CHI: 300h [*’^ current **] 

CH2: 340h 
CH3: 240h 
F2: Loopback Mode 

CHI: Normal operation [** current **] 

CH2: Test mode 
F3: Interrupt Channel (IRQ) 

CHI: 3 
CH2 : 4 

CH3: 5 [** current **] 

CH4 : 7 

Changing Choices for Board Functions 

If eisa_config cannot automatically generate a new configuration with 
the choices currently selected, you can use the change command to 
specify an alternative choice for a particular function on a board. A board 
must al ready be part of the configuration before you can use the change 
command on it. 

Use the change command cautiously, because it overrides any choice 
eisa_config might make, even to resolve a conflict. 

To change a choice for a given function, issue the change command, 
specifying the slot number, function number (f#), and the new choice 
number (ch#), as shown by the show board slot# command. 

EISA: change slot# function# choice# 

After making all desired changes within eisa_config, exit the program, 
as explained in the next section. 

Exiting eisaconfig 

Once you have changed the configuration, eisa_conf ig prompts you to 

• save the changes and exit, 

• exit without saving changes, or 

• abort the exit. 

When you save the changes, eisa_config displays a list of subsequent 
steps. 
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EISA: quit 

A description of the configuration was saved in 
/var/adm/eisa/config.log. 

If eisa_config was run per the instructions of a specific 
product 

installation manual, refer to that manual for specifics on 
device file 

creation and I/O drivers. 

Step 4 may apply if other cards were affected. 

Otherwise, the following is a list of generally required steps: 

(1) Make any necessary device files. If you have moved a 
board you 

may also need to make new device files. 

(2) Ensure that all appropriate software I/O drivers are 
present 

in the kernel. 

(3) Shut down the system with the "/usr/sbin/shutdown -h" 
command. 

(4) Once the system is shut down, turn the power off. Then 
set any 

physical switches and jumpers correctly. The switches 
and jumpers 

that have changed since eisa_config was invoked are 
listed below. 

The file /var/adm/eisa/config.log contains a summary 
of the new 

configuration, including required switch and jumper 

settings. 

(5) Physically add, move, or remove boards as needed. 

(6) Turn the power on and boot the system. 

Displaying Switch and J umper Settings 

Once you exit, eisa_configdisplaystheswitch andjumper settings that 
have changed si nee the program was invoked. For example, 

Slot 2 

XYZ Networking Board 

Switch Name: I/O Base Address 

Switches I through 3 select the I/O Base Address, 
switch 4 is not applicable. 

NOTE: 'off' in the diagram below corresponds to 'OPEN' on 
board 
switches. 

Default setting 
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10 0 1 

Required setting 

10 0 1 

+-x-+-+-+-x-+on 

I I I I 

+-+-x-+-x-+-+off 

12 3 4 


Slot 2 

XYZ Networking Board 
Switch Name: Loopback Mode 


Default 

Required 

on 

+-+ 

off 


0 

0 

1 

+-+ 

X 

4 

0 

0 

1 

+-+ 

X 

3 

0 

0 

1 

+-+ 

X 

2 

0 

0 

1 

+-+ 

X 

1 


Exiting eisa_config. 

$ 

Saving the Configuration and Exiting eisa config 

You can save the current configuration without exiting eisa_config by 
using the save system, sci command. 

If the current configuration is not conflict-free, eisa_config notifies you 
and does not save the configuration. 

By default, save records the new configuration in non-volatile memory 
(NVM). If you use system, sci, save does not record the new 
configuration in NVM, but instead, records it in the system.sci file. 
This file can be used to configure subsequent workstations. See 
"Creating Identical E/I SA Configurations on Other Workstations" later 
in this chapter. 

When you quit eisa_config, it creates the /etc/eisa/config. log file, 
which contains information on all currently configured boards and their 
attributes. 

Your next task will be to bring down the system, set the physical 
switches and jumpers to match the new eisa_config specifications, and 
reboot. 
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Setting Switches and J umpers on an E/I SA I nterface Board 

When you exit eisa_config or use the show switch changed command, 
you seea graphical representation of the switch and jumper settings that 
have changed during the eisa_config session. The 
/etc/eisa/config. log file also contains all requi red switch and jumper 
settings for each board in your working configuration. To set the switch 
and jumper settings, 

1. Print the /etc/eisa/config. log file as a record of all switch and 
jumper settings that have changed during the eisa_config session. 

2. Warn all users that you will be shutting down the system to configure 
the E/I SA board. Then shut down the system and turn the power off. 

3. Set the switches and jumpers to their required settings, as 
determined by eisa_config. If you are installing a new board, add it 
at this time. If you are installing a peripheral device with this board, 
connect the device. 

4. Turn on all peripheral devices, then theSPU, and reboot the system. 

When the system boots, the E/I SA board settings are written to 
non-volatile memory (NVM), making the boards fully accessible by 
HP-UX. 


Moving an E/I SA Board 

To move a currently configured E/I SA board. 

Step 1. Invoke /sbin/eisa_config and at the EISA: prompt, issue the move 
command, specifying the board's current and new slot numbers. 

EISA: move current_slot# new_slot# 

Step 2. After moving all desired boards within elsa_conflg, exit the program. 

eisa_config will display any switch and jumper settings that may have 
changed during the session. Refer to the /etc/eisa/config. log file for 
a record of the new configuration, including the required settings. 

Step 3. Remove the old device file for the board with the rmsf command. 

Step 4. Warn all users that the system will be brought down. Halt the system 
with the shutdown command and turn off the power. 

steps. Set any physical switches and jumpers according to eisa_config 
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requirements. Refer to "Setting Switches and J umpers on an E/I SA 
I nterface Board". 

Step 6. Physically move the boards. 

Step 7. Turn the power on and reboot the system. As the system boots, the new 
configuration is written toNVM and /etc/eisa/system. sci. 

If the devices attached to the board use drivers known to insf (for 
example, SCSI devices), insf creates device special files for them at their 
new location. If the driver is not known to insf (for example, if you are 
installing a custom board), usemknod to create any required device 
special files. Consult the documentation accompanying the board and/or 
device for guidance. 


NOTE I f you are movi ng a network board, you need to boot the computer a 

second time. Use shutdown -r. 


Removing an E/ISA Board 

To remove a currently configured E/I SA board. 

Step 1. I nvoke /sbin/eisa_config and at the EISA: prompt, issue the remove 
command, specifying the slot number from which you are removing a 
board. 

EISA: remove slot# 

Step 2. After removing all boards desired within eisa_config, exit the program. 

Step 3. Remove the old device file for the board with the rmsf command. 

Step 4. Warn all users that the system will be brought down. Halt the system 
with the shutdown command and turn off the power. 

Step 5. Physically removethe boards. 

Step 6. Turn the power on and reboot the system. As the system boots, the new 
configuration is recorded in NVM. 
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Creating Identical E/ISA Configurations on Other 
Workstations 

If you have several workstations with identical E/ISA boards, you can 
streamline the configuration task as follows: 

Step 1. I nvoke /sbin/eisa_config on the first system and configure the E/I SA 
boards to your satisfaction. 

Step 2. Save the configuration in a system, sci file instead of to NVM. 

EISA: save system.sci 

Step 3. Complete the configuration task for the first workstation, by exiting 

eisa_config, making any necessary physical changes to the boards, and 
reboot! ng the system. 

Step 4. When you are ready to configure other workstations, copy the cfg and 
system, sci files from the first workstation to those systems. (Note, if 
the workstations share a file system, you might not need to copy the files 
at all.) 

On each of the other workstations, invoke eisa_config using the -n 
option, which initializes the E/ISA configuration from system.sci. 

eisa_config -n system.sci 

Step 5. Save the new E/I SA configuration using the save command. 

By default, eisa_config records the configuration in the NVM and to 
/etc/eisa/system.sci. Optionally, if you specify a file (for example, 
tmp.sci) as an argument to the save command, eisa_config records 
the configuration to the specified file. 

EISA: save [tmp.sci] 

Successfully saved configuration in tmp.sci. 

You can copy the tmp.sci file to the systems for which you are 
duplicating the original configuration. Then, from eisa_config on the 
new system, use the init command to write the configuration to NVM 
and /etc/eisa/system.sci of the new system. 

Step 6. Complete the configuration task by exiting eisa_config, making any 
necessary physical changes to the boards, and rebooting the system. 
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Troubleshooting E/ISA Board Configuration 

Begin by reading the system messages displayed by the dmesg command. 
Then consult this section and "E/ISA Board Power-Up Messages" shortly 
for possible causes and recommended actions. 

Verifying the Syntax of a CFG File 

If an E/I SA board is not configuring properly, check the cfg file syntax, 
using the -c option. 

Note, theeisa_config -c option is useful only for diagnosing errors in a 
particular cfg file, not for changing the configuration. 

# eisa_config -c HWPC051 

Checking this CFG File for correctness: 

/sbin/lib/eisa/HWPC051.CFG 

Successful syntax verification 


Board Stops Working or No Non-Volatile Memory 
(NVM) Driver 

If a board that was working suddenly stops working or the system 
reports that the NVM driver cannot be used, the kernel might have been 
altered and now lacks the required device drivers. Ifso, you will need to 
relink the E/I SA board drivers to the kernel. 

See "Configuri ng the Software Requi red by the E/I SA Board" or board 
documentation supplied by the manufacturer. 

Added or Moved Board Does Not Work 

If you added or moved an E/I SA board that is not working, check the 
following: 

Step 1. If you added the board using automatic mode, check 

/etc/eisa/config.err for error messages. 

step 2. Did you add the required drivers to the H P-UX kernel? If not, see 
"Configuri ng the Software Requi red by the E/I SA Board". 
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Step 3. If you added the board interactively, did you save the new configuration 
before exiti ng eisa_config? I f not, run eisa_config agai n, add the 
board agai n, and then save the configuration. See "Savi ng the 
Configuration and Exiting eisa_config." 

Did you change any switch and jumper settings to match the settings 
specified in /etc/eisa/config.iog? If SO, verify that you did so 
accurately. 

Step 4. Did you reboot the system after changing the configuration interactively? 
If not, reboot the system, taking care to warn users first. 

Step 5. Did you create the necessary device special files correctly? For 

HP-supplied boards, insf will have created the necessary device special 
files for any attached devices on rebooting. For boards supplied by a 
different manufacturer, refer to the documentation shipped with your 
board. I f the driver is not known to insf, use mknod to create any 
required device special files. 

Board Configuration Conflicts 

E/l SA boards use four types of resources: interrupt lines, DMA channels, 
register addresses, and memory. I f the automatic mode of eisa_conf ig 
cannot configurea board due to resource conflicts, you may still be able 
to use eisa_config interactively to add a board that had a conflict or to 
change choices for a new board. Refer to "Changing Choices for Board 
Functions". 

If your desired board configuration still causes conflicts, you may not be 
able to use certain boards together. Some configurations are simply not 
possible; for example, two boards from different manufacturers may both 
require the same resource. If this happens, only one of the boards can be 
used. 

Two CFG Files Have the Same Name 

If you want to load a cfg file into the /sbin/iib/eisa directory that has 
the same name as a file already in that directory, follow these steps: 

Step 1. Load the new cfg file from media into a temporary directory. 

Step 2. Rename the cfg file, using the same syntax as described in "E/l SA 
Boards and CFG Files", at the beginning of this appendix. I n the 
temporary directory, type the foil owing command: 
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mv oldname newname 

Step 3. Movethe renamed CFGfiletothe /sbin/iib/eisa directory. Type the 
following command: 

mv -i newname /sbin/lib/eisa 

Boards that have duplicate CFGfile names must be added using 
eisa_config interactively (see "Configuring E/I SA Boards Using 
Interactive Mode") earlier. 
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E/ISA Board Power-Up Messages 

This section contains a listing of E/I SA board power up messages, their 
potential cause, and action you can take to correct the problem. 

Several messages displayed are informational only. They indicate that 
configuration completed successfully. 


Message: 

Cause: 

Action: 

Message: 

Cause: 

Action: 

Message: 

Cause: 

Action: 


Message: 

Cause: 

Action: 

Message: 

Cause: 


No EEPROM Data -> EISA Card ID: eisa_id 

An El SA card identified itself, but non-volatile memory 
(NVM) has no configuration data for the slot. 

Run eisa_config to Update NVM. 

Cannot read EISA card ID 

NVM recognizes that the card exists, but cannot read 
its ID. 

If a card is present, there is a hardware problem. 
Replace the card. If a card is not present, ignore the 
message. 

Board ID: eisa_id inconsistent with NVM ID: 
eisa_ld 

The ID read from the card does not match the card ID 
information stored in NVM. 

If board has been moved, run eisa_config in 
automatic mode. If this message persists after running 
eisa_config and updating NVM, replace the board. If 
board has been removed, ignore the message. 

Bad eeprom data for board eisa_id 

An attempt to read the NVM configuration information 
failed. This represents a system problem. 

Call your HP representative. 

Error initializing board eisa_id 

An attempt to initialize the card with the stored NVM 
initialization data failed. 
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Action: 

Check CFGfilefor inaccuracies. Suspect a hardware 
problem. 

Message: 

EISA Board ID:eisa_id ignored 

Board not present or driver not configured into 
kernel 

Cause: 

The ID displayed was obtained from NVM, not the 
card. E ither an ISA card is present, but not its driver or 
the driver is present, but not the card. (Since ISA cards 
do not identify themselves, only the card's driver can 
verify its existence.) 

Action: 

Ensure the card in installed and verify that the driver 
is configured into the kernel. 

Message: 

EISA Board ID: eisa_id ignored 

Driver not configured into kernel 

Cause: 

The system found the EI SA card, but not its driver. 

Action: 

Verify that the driver is configured into the kernel. 

Message: 

EISA Board ID: eisa_id ignored, error 
initializing board 

Cause: 

A driver accepted this card, but failed to initialize it. 

Action: 

This is probably a defective card. 

Message: 

EISA: eisa_last_attach not called, bad driver 
in kernel 

Cause: 

If a driver does return correctly from its attach routine, 
this will panic the kernel. Assuming that the drivers 
installed are working, this message should never 
appear. 

Action: 

I f you are usi ng a non-H P card and driver, remove both 
the card and driver and try again. If error does not 
recur, the non-H P driver is bad. If the error recurs, call 
your HP representative. 

Messages: 

EISA WARNING: mapping in system board failed 
EISA WARNING: mapping in I/O map entries failed 

Causes: 

System encountered problems either in creating 
virtual-to-physical mappings of the EISA system board 
registers or in attempting to initialize a system board 
resource. 
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Action: 

Message: 

Cause: 

Action: 

Message: 

Cause: 


Action: 

Message: 

Cause: 


Action: 


If either of these messages appear while booting from 
EISA SCSI, the system wi 11 fai I to boot. I f booti ng from 
other than EI SA SCSI, the EI SA cards wi 11 not be 
recognized. 

Call your HP representative. 

slot_num Slot EISA Expander Initialized: 
eisa_id 

This informational message indicates that the bus 
adapter located between the EISA bus and the host 
system bus initialized properly. It also indicates how 
many slots the kernel is configured to recognize. 

None. 

EISA SLOT slot_num 

This informational message indicates which slot is 
currently being initialized. When successful, each 
driver displays its own initialization message. For 
example: 

EISA SLOT 1: driver_specific_message 

None. 

Successfully Initialized EISA Boot Device 

The system recognized a special case. If the system 
boots from EI SA SCSI before EISA SCSI configuration 
information is stored in N VM, the processor-dependent 
code uses default configuration data that might conflict 
with other EISA cards in the system. To handle this, 
the system ignores all cards except the boot EISA SCSI 
during the first power-up and continues a limited boot. 

If eisa_config (run in / sbin/bcheckrc) Can create a 
valid configuration, it records it in NVM and the 
system, sci file, and the system is automatically 
rebooted. If a valid configuration cannot be created, 
eisa_config issues an error message, the system 
comes up with the other cards unusable. I n this case, 
you can run eisa_config interactively to fix the 
configuration and to reboot manually. 

None. 
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Message: 

Cause: 

Action: 

Message: 

Cause: 

Action: 

Messages: 


Cause: 


Action: 

Message: 

Cause: 


Skipping 

Either the slot is empty, or NVM reports the slot is 
empty, or the slot has an ISA card but no EE PROM 
data, or the slot was skipped because of an already 
cited circumstance. 

None. 

EISA card id eisa_id in slot slot_num had fatal 
error 

An EISA card asserted the lOCHK line indicating a 
fatal error. An expansion card might do this if there 
was a parity error on a memory card. (Not all cards 
assert lOCHK.) 

Replace the card. 

EISA_WARNING: unable to allocate eeprom_geninfo 

EISA_WARNING: unable to allocate 

eeprom_slot_info for slot 0 
EISA_WARNING: unable to allocate 
eeprom_slot_info 

EISA WARNING: unable to allocate: func_data 

EISA_WARNING: unable to allocate 

eeprom_cfg_header 

EISA WARNING: unable to allocate eeprom 
WARNING: unable to map eeprom registers 
EISA WARNING: unable to map eeprom 

These warnings indicate system problems when 
attempting to allocate resources necessary for El SA 
initialization. If booting from an EISA device, the 
system will not boot up. If not booting from an EISA 
device, the system will boot up but EISA will not be 
initialized. 

Call your HP representative. 

EISA_WARNING: NVM checksum invalid, clearing 
eeprom 

A checksum failed when performed on NVM at 
power-up, causi ng the system to erase the contents of 
non-volatile memory. As El SA comes up, it will 
complain that NVM data is missing for cards that 
identify themselves. eisa_config running from 
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Action: 


/etc/bcheckrc will automatically generate data for 
and reconfigure the EISA cards that are present. You 
will need to reconfigure I SA cards, by running 
eisa_config interactively. 

Follow instructions in "Configuring E/I SA Boards 
Using I nteractive Mode". 
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Bus Architectures 


This Appendix contains a sampling of HP bus architecture diagrams. In 
some cases, ioscan output is provided to help you associate the 
hardware configuration and the software display. 

Addressing on a typical multi-function (personality) card is also 
explained. 
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Series 700 Bus Architecture 

Since its initial introduction, the Series 700 has grown enormously in 
breadth and configurability. The figures shown illustratethe Series 700 
configured as a workstation, although Model 735 can be configured to 
support additional 735 or 755 workstations as a cluster server. The 
Model 770 features multi pie GSC+buses, for versatility and I/O 
efficiency. 

Model 712 

Figure B-l, "Model 712 Bus Relationships," shows the Model 712 bus 
diagram, which has capability for up to 2 graphics cards and 2 graphics 
monitors (which show up on ioscan as 0 and i). Core I/O descends from 
slot 2 off the system bus, and optional cards show up as slots 5 or 6. 
Optional cards include support for IBM TokenRing, LAN, X.25, serial, 
and telephony. A third-party card is also configurable for video and 
multimedia capabilities. 

Sample Addresses 

A parallel printer is likely to have a hardware address of 2 / 0 / 6 . o. A disk 
might have an address of 2 / 0/1 . 5 . 0 , if the SCSI address on the device 
itself were set to 5. 
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Figure B-1 Model 712 Bus Relationships 



Model 725/100 

Figure B-2, "Mcxiel 725/100 Bus Relationships," shows a sample layout 
for a Model 725/100, and the example that follows it shows its ioscan 
-fn output. 

The 725 has capability for up to 4 graphics monitors. Core I/O descends 
from slot 2 off the system bus, and optionally at slot 5. E/I SA interface 
cards configure at slot 4 , and additional I/O cards (such as multiple 
fast/wide SCSI interfaces and graphics accelerators) can be installed at 
slots which show up in ioscan as lO and ii. 

Sample Addresses 

Audio capabilities are accessed through hardware address 2 / 0 / 8 . Access 
tothe FDDI network would be addressed through 2/0/9. If a Fast/Wide 
SCSI interface were plugged into slot lo and a disk whose SCSI address 
is set to 6 were attached to that interface, the disk would be addressed 
through 10 / 0 / 0 . 6 . 
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Figure B-2 Model 725/100 Bus Relationships 



Class I H/W Path Driver S/W State H/W Type 

Description 


be 0 

graphics 0 0 

Graphics 
ba 0 2 

I/O Adapter 
ext_bus 0 2/0.1 

Built-in SCSI 
target 0 2/O . 1.3 

tape 0 2/O . 1.3.0 

HP35480A 

/dev/rmt/cOt3dONOMODn 

/dev/rmt/cOt3dONOMODnb 

/dev/rmt/cOt3dONOMOD 

/dev/rmt/cOt3dONOMODb 
target 1 2/O.1.4 

disk 0 2/0.1.4.0 

97560 


root CLAIMED 

graph3 CLAIMED 

bus_adapter CLAIMED 

c700 CLAIMED 

target CLAIMED 

stape CLAIMED 

/dev/rmt/c0t3d0BEST 

/dev/rmt/c0t3d0BESTb 

/dev/rmt/c0t3d0BESTn 

/dev/rmt/c0t3d0BESTnb 

target CLAIMED 

sdisk CLAIMED 


BUS_NEXUS 

INTEREACE 

BUS_NEXUS Core 

INTEREACE 

DEVICE 

DEVICE HP 


DEVICE 

DEVICE 


/dev/dsk/c0t4d0 /dev/rdsk/c0t4d0 
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target CLAIMED DEVICE 

sdisk CLAIMED DEVICE SEAGATE 

/dev/dsk/cOtSdO /dev/rdsk/cOtSdO 
target CLAIMED DEVICE 

sdisk CLAIMED DEVICE SEAGATE 

/dev/dsk/c0t6d0 /dev/rdsk/c0t6d0 
lan2 CLAIMED INTEREACE Built-in 

/dev/etherO /dev/lanO 

hil CLAIMED INTEREACE Built-in 

/dev/hill /dev/hil7 /dev/hil_0.6 

/dev/hil2 /dev/hil_0.1 /dev/hil_0.7 

/dev/hil3 /dev/hil_0.2 /dev/hilkbd 

asioO CLAIMED INTERFACE Built-in 

/dev/diag/muxO /dev/muxO 


Centif 


CLAIMED 


INTEREACE 


audio CLAIMED INTEREACE 

/dev/audioBA /dev/audioEL_0 

/dev/audioBA_0 /dev/audioEU 


target 

2 

2/0.1.5 

disk 

ST3600N 

1 

2/0.1.5. 

target 

3 

2/0.1.6 

disk 

ST3600N 

2 

2/0.1.6. 

Ian 

LAN 

0 

2/0.2 

hil 

HIL 

0 

2/0.3 


tty 0 

2/0.4 

RS-232C 



/dev/ttyOpO 


ext_bus 

1 

2/0.6 

Centronics 

Interface 

audio 

0 

2/0.8 

/dev/audioLL 


/dev/audioLL_ 

_0 

ba 

Adapter 

I 

4 

processor 

Processor 

0 

62 

memory 

0 

63 


eisa CLAIMED 
processor CLAIMED 
memory CLAIMED 


BUS_NEXUS EISA 
PROCESSOR 
MEMORY Memory 


Model 770 0 Series) 

TheMcxdel 770 features increased expandability on dual GSC buses, 
ioscan output for this system is found in several examples in Chapter 1, 
"Getting Started." 
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Figure B-3 Model 770J Series Bus Relationships 
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Model E Systems 

McxJd E computers report 806 when queried with uname -a. Slots 9 
through 12 (addresses 56 / 36 . xto 56 / 48 . x) support HP-PB cards, as 
shown in Figure B-4, "HP 9000 Model E Bus Relationships." 

Figure B-4 HP 9000 Model E Bus Relationships 





Addressing on Multi-Function Cards (Model E Example) 

Slots 13 and 14 (addresses 56/52.xto 56/56.x) of Model E systems are 
reserved for one of two multi-function (personality) cards. 
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Table B-1 


• MUX-based multi-function I/O card, containing single-ended SCSI, 
parallel port, and 8 or 16 RS-232-C ports for console, access port for 
remote console, and other serial devices. 

• LAN-based multi-function I/O card containing 802.3 LAN, serial 
connection for PowerTrust U PS, and remote modem access port with 
security option to defeat inadvertent system resets (control-B MUX 
defeat switch). 

TableB-1, "HardwareAddresses of Multi-Function I/O Cards," shows the 
hardware addresses for a sample Model E multi-function card. 

Figure B-5,'Typical I/O Addressing for a M UX/SCSI Multi-Function 
Card," shows how multiple functions on Model E map to the bus 
architecture. (Note, this figure shows a detail of Figure B-4, "FIP 9000 
Model E Bus Relationships.") 

Hardware Addresses of Multi-Function I/O Cards 


Slot Number 

Hardware Path 

Peripheral Device 

13 

56/52.SCSIJD 

SCSI device 

13 

56/53.0.device_address 

Parallel printer 

14 

56/56.0 

Console 

14 

56/56 port 7 

Remote console 

14 

56/56 port 1 

UPS PowerTrust 

14 

60.6 

LAN 
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Figure B-5 Typical I/O Addressing for a MUX/SCSI Multi-Function Card 



The following excerpted terse ioscan output shows only the entries for 
the interfaces represented by a sample multifunction card. 


H/W Path 

Class 

Description 


56/52 

ext_bus 

HP 28655A - 

SCSI Interface 

56/53 

ext_bus 

HP 28655A - 

Parallel Interface 

56/56 

tty 

MUX 



Models F/G/H/l and 8x7 Systems 

All I/O occurs through the H P Precision Bus (H P-PB) on Models F/G/H/l 
and 8x7. Figure B-6, "Basic Addressing on Models F/G/H/l and 8x7 
Systems," illustrates the bus relationships in simplified form, for 
addressing purposes. Two multi-function (personality) cards can be 
configured on HP-PB: 
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• LAN-based multi-function I/O card (standard) containing an 802.3 
Thin LAN interface, two serial interfaces (RS-232-C console port via 
circular Dl N connector and access port for remote console), and a 
single-ended SCSI interface. 

• MUX-based multi-function I/O card (optional) containing 8 modem (or 
8 modem and 8 direct-connect) RS-232-C ports, a single-ended SCSI 
interface, and a parallel port. 

Sample Addresses 

The three SCSI disks shown would have addresses of 52.6, 52 . 5 , and 
52 . 4 . A 802.3 LAN card plugged into slot 4, has LAN access through 
address i6.i. 

Figure B-6 Basic Addressing on Models F/G/H/l and 8x7 Systems 
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Models 890 and T500 Systems 

Figure B-7, "HP 9000T500Configuration and Bus Relationships,"shows 
the configuration of a T500 system, a large system with enormous 
expandability; also included is excerpted loscan output 

Sample Addresses 

The console is likely to have an address of 0/44. o. A disk array 
containing four disks might show several addresses (for example, 
2 / 52 . 2 . 0 , 2 / 52 . 3 . 0 , 2 / 52 . 4 . 0 , and 2 / 52 . 5 . 0 ) if attached to a SCSI 
card at slot 13 in an expansion cabinet (bus converter 2/) and configured 
in RAID I ndependent mode, which treats each spindle separately. 
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Figure B-7 HP 9000 T500 Configuration and Bus Relationships 



Class I H/W Path Driver S/W State H/W Type 

Description 
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be 

1 

0 

be 

Converter 



tty 

0 

0/16 mux2 

- 16 RS 

-232 MUX 


ext_bus 

2 

0/28 

scsi3 

Fast/Wide SCSI Interface 

disk 

12 

0/28.0.0 

disc3 

C2430D 

- SCSI 

Disk 


disk 

13 

0/28.1.0 

disc3 

C2430D 

- SCSI 

Disk 


lanmux 

0 

0/44 

lanmuxO 

LAN/Console 



tty 

2 

0/44.0 

mux 4 

Ian 

0 

0/44.1 

lan3 

lantty 

0 

0/44.2 

lanttyO 

ext_bus 

5 

0/52 

scsil 

28655A 

- SCSI 

Interface 

disk 

14 

0/52.0.0 

disc3 

C1716C 

- SCSI 

Disk 


disk 

5 

0/52.1.0 

disc3 

- SCSI 

Disk 



disk 

6 

0/52.2.0 

disc3 

- SCSI 

Disk 



disk 

7 

0/52.3.0 

disc3 

CD-ROM 




tape 

0 

0/52.4.0 

tape2 
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Models 8x9 (K Series) 

McxJds 8x9 share features in common with the McxJel 770 (J Series) — 
dual GSC+busesand multi pie graphics capability. In addition, theK 
Series systems also provide H P-PB buses. This allows for both WSIO and 
SIO functionality on the same computer. 

Figure B-8, "Model 8x9 K Series Bus Relationships," illustrates the bus 
relationships; also included is excerpted ioscan output. 

Figure B-8 Model 8x9 K Series Bus Relationships 
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Major and Minor Numbers 


This appendix addresses speciai situations in which HP-UX does not 
configure a driver automaticaiiy or create the required device speciai 
fiies. For exampie, you might need to configure a custom driver for 
biack-boxor instrumentation appiications. 

if the proper code is present in the driver, insf can create device speciai 
fiies automaticaiiy and H P-UX can recognize the device, but you might 
stiii have to create a customized device speciai fiiefor the instrument to 
work properiy. 

To configure H P-UX for non-standard device drivers or devices, you may 
need to: 

1. Configure the custom driver intothe kernei. 

2. Create device speciai fiies for the device using either mksf or mknod 
commands. 

Tabies in this Appendix provide you with the information to construct a 
minor number for any H P device driver. You shouid aiso consuit the 
manpagesin Section 7oftheHP-UX Reference for the type of device 
driver you are configuring. For non-H P drivers, consuit the 
documentation provided with the device. 
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Understanding how the Kernel Associates 
Drivers to Device 

The kernel communicates with the hardware by associating the driver 
name with a hardware address. The kernel identifies the drivers it needs 
from the /stand/system file and finds them using the files in the 

/usr/conf/master.d directory. 

All standard HP-UX interface and device drivers shipped are located in 
the library /usr/conf/lib/libhp-ux.a. 

The kernel recognizes interface and device drivers (and by extension, 
peripheral devices) by major and minor numbers encoded into the device 
special files. 

Figure C-1 Device Special Files Contain Major and Minor Numbers 



LG200172_042 


Each device driver in the system is assigned a major number, which the 
kernel uses to locate the driver routine to service an I/O request. 

The driver uses the minor number to locate the specific device and for 
information regarding how to handle data. 

Major Numbers 

The major number is an index for the device driver into one of two kernel 
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tables — bdevsw, the block device switch table and cdevsw, the character 
device switch table. 

Drivers that support both block and character I/O (such as SCSI disk 
driver and optical autochanger) have both a block major number and a 
character major number. Devices that support only character-mode 
access have only a character major number. 

The core-hpux file in /usr/conf/master.dCOntainsaDriver install 
table, which lists major numbers for reference only. 

To identify valid major numbers for devices configured on your system, 
you can execute the isdev command. 

isdev reads the driver headers and lists the drivers configured into the 
kernel with their block and character major numbers. If the driver is 
designed to use a dynamically assigned major number, isdev displays 
the assigned major number. 

Major numbers are displayed in decimal form. The-i designation in 
either character or block major number field of isdev output can mean: 

• The device might be a module that is not a driver. 

• No driver is configured. 

• Driver is not supported in that block or character mode. 

Minor Numbers 

Minor numbers represent two kinds of information: the location of the 
interface to which a device is attached and driver-dependent 
characteristics. This information is organized by specific bit 
assignments. 

The tables later in this Appendix show the bit assignments for many 
HP-UX device drivers. You can also consult the device driver manpagein 
section 7 of the HP-UX Reference For non-HP drivers, consult the 
documentation provided with the driver. 
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Understanding the Construction of Device 
Special Files 

A long listing (is -i) of a typical device special file might look like this: 

crw- 2 bin bin 193 0x010200 Jul 12 02:19 ttYlp2 

The two shaded fields arethe major (193, decimal) and minor (0x0i0200, 
hexadecimal) numbers. 

Both major and minor number are encoded into a numerical designation 
of the device driver, called the dev_t format.Thisisshown in FigureC-2, 
"Driver Number (dev_t) Format." (Note, PA-RISC uses "Big-Endian" byte 
ordering; that is, the bit labelled o is the most significant (high-order) 
bit.) 

Figure C-2 Driver Number (dev t) Format 
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Driver 
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Interface 

Card 
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Characteristics 



Bits 0 through 7 of an FIP-UX device special file are used to encode the 
major number. 

Bits 8 through 31 are used to encode the minor number. The hexadecimal 
notation for the minor number follows the format OxNNNNNN, in which 
each four bits (shown as n or "nibble") is represented by a hexadecimal 
digit (0 through f, in which o means no bits are set, f means all bits are 
set). 

Bits 8 through 15 encode the card instance of the interface card, that is, 
the number representing the order that FI P-UX encounters the specific 
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class of the interface card when binding it into the system. This number 
is displayed (in decimal notation) in the i column of loscan output. 

Bits 16 through 31 encode driver-dependent characteristics, which are 
documented in Table C-4, "Bit Assignments for Tape Devices,"TableC-5, 
"Bit Assignments for Disk and Magneto-Optical Devices,"TableC-6, "Bit 
Assignments for Serial, Network, and Line Printer Devices," and Table 
C-7, "Bit Assignments for Miscellaneous Devices."You can use these 
tables to construct custom minor numbers, when you require a driver to 
recognize or use specific or non-standard features of a device. 

Table C-1, "Decimal, Binary, and Hexadecimal Equivalents," may be 
useful for translating bit assignments into hexadecimal digits. 

Table C-1 Decimal, Binary, and Hexadecimal Equivalents 


Decimal 

Binary 

Hex 

0 

0000 

0 

1 

0001 

1 

2 

0010 

2 

3 

0011 

3 

4 

0100 

4 

5 

0101 

5 

6 

0110 

6 

7 

0111 

7 

8 

1000 

8 

9 

1001 

9 

10 

1010 

A 

11 

1011 

B 

12 

1100 

C 

13 

1101 

D 

14 

1110 

E 

15 

nil 
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Examples of Minor Number Creation 

A Minor Number for a MUX Driver 

The minor number 0 x0i0200 shown earlier for themux2 driver can be 
represented as follows: 

Minor Number for the MUX2 Driver 


bits 

8-11 

12-15 

16-19 

20-23 

24-27 

28-31 

binary 

0000 

0001 

0000 

0010 

0000 

0000 

hex (Ox) 

0 

1 

0 

2 

0 

0 


0000 0001 The eight bits of the card instance number is 1 (ttyi in 
the device special filename). 

0000 0010 The port address is 2 (p2 in the device special file 
name). 

0000 0000 The remaining bits are set to zero. 

A Minor Number for a SCSI Disk Device 

The minor number 0x023000 represents a SCSI disk device set with a 
SCSI address of 3, connected to a SCSI interface at card instance 2, and 
might be shown as follows: 

Minor Number for a SCSI Disk Device 


bits 

8-11 

12-15 

16-19 

20-23 

24-27 

28-31 

binary 

0000 

0010 

0011 

0000 

0000 

0000 

hex (Ox) 

0 

2 

3 

0 

0 

0 


0000 0010 The eight bits of the card instance number is 2 (c2 in a 
device special file name). 

0011 The SCSI address (target) set on thedeviceis3 (t3 in a 

device special file name). 

0000 0000 0000 The remaining bits are set to zero. (dO in a device 
special file name). 
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Adjusting Bits to Read a Floppy Disk 

Media used by tape drives and floppy disk drives have different 
densities. There might betimes when you need to read a floppy disk that 
was written on oider technoiogy. 

For exampie, a Series 800 Modei E computer has a buiit-in SCSi floppy 
disk drive whose typicai minor number is OxOOSOOO. However, when 
attempting to read a floppy disk originaiiy created on a 2.88MB drive, 
you might want to create minor numbers 0x005004 and 0x005005. As 
shown in TabieC-5, "Bit Assignments for Disk and Magneto-Opticai 
Devices," both minor numbers adjust bits in the range 28-31 to 
accommodate the 2.88MB drive, andaiiowyou to try to read the diskette 
with or without a set geometry determined. 


Appendix C 


243 



Major and Minor Numbers 

Minor Number Bit Assignments 


Table C-4 


Minor Number Bit Assignments 

The tables on the following pages show the bit assignments for bits 16 
through 31 for the principal HP device drivers. In all cases, bits 8 
through 15 (that isNNin hexadecimal Oxnnoooo) encode the card 
instance of the interface card through which the device communicates. 


Bit Assignments for Tape Devices 



bits 16-19 

20-23 

24-27 

28-31 

shape 

tape2 

SCSI target 

SCSI LUN 

24 - BSD behavior at close 

25 - No rewind 

26 - Conhguration method ^ 

27-31 - Index/Density ’’ 


a. If 1, bits 27-31 mean Index. If 0, bits 27-31 mean Density. 

b. Index and Density are generated as needed by mksf{\M). Density is 
encoded as a field in the minor number, using a constant of the form 
DEN_M_*, as dehned in /usr/include/sys/mtio .h. Index refers 
to an index into the property table used to specify extended 
conhguration options (using the mt_propertY_type data structure 
dehned in /usr/include/sys/mtio. h.) For further discussion, see 
mt (7) in the HP-UX Reference. 
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Table C-5 


Bit Assignments for Disk and Magneto-Optical Devices 



bits 16-19 

20-23 

24-27 

28-31 

disc3 

SCSI target 

SCSI LUN 

Reserved 

Section 

number 

disc4 

SCSI target 

SCSI LUN 

(always 0) 

Reserved 

Section 

number 

sdisk 

SCSI target 

SCSI LUN 

Reserved 

Disk 

partition 

number 
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Table C-5 


Bit Assignments for Disk and Magneto-Optical Devices 



bits 16-19 

20-23 

24-27 

28-31 

sflop 

SCSI target 

SCSI LUN 

Reserved 

0=3.Sin 

1.44MB 
drive, geom 
determined 
(default) 

l=3.5in 
1.44MB 
drive, no 
geom 

determined 

(SoftPC) 

2=3.5in 

720KB drive, 
geom 

determined 

3=3.Sin 

720KB drive, 
no geom 

determined 

4=3.Sin 
2.88MB 
drive, geom 
determined 

S=3.Sin 
2.88MB 
drive, no 
geom 

determined 
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Bit Assignments for Disk and Magneto-Optical Devices 



bits 16-19 

20-23 

24-27 

28-31 





6=not 

supported 

7=not 

supported 

8=5.25in 

1.2MB drive, 
geom 

determined 

8=5.25in 
360KB drive, 
geom 

determined 

9=5.25in 

1.2MB drive, 
no geom 

determined 

9=5.25in 
360KB drive, 
no geom 

determined 

schgr 

autox 

0 

SCSI target 

20-22 - SCSI LUN 23-31 - Surface 
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Bit Assignments for Serial, Network, and Line Printer Devices 



bits 16-19 

20-23 

24-27 

28-31 

asio 

0 

16-17- 
Receive fifo 
trigger level 
18-19- 
Transmit fifo 
limit 

Reserved 

24 - Card 
diagnostic bit 

25 - Reserved 

26 - Reserved 

27 - Hardware 
flow control 
enable 

28 - Reserved 

29 - Protocol 

0=Bell, 1=CCITT 

30-31 - Access 
mode 

00=Direct 
01=Dial-out 
modem 10=Dial-in 

modem 

muxO 

mux2 

mux 4 

16-23 - Port number 

24 - Card 
diagnostic bit 

25 - Port 
diagnostic bit 

26 - Reserved 

27 - Hardware 

flow control 

enable 

28 - Reserved 

29 - Protocol 

0=Bell, 1=CCITT 

30-31 - Access 
mode 00=Direct 
01=Dial-out 
modem 10=Dial-in 

modem 

lanO 

lanl 

lan2 

lan3 

16-23 - Reserved 

24 - Diagnostic access 

25-30 - Reserved 

31 - Protocol 1=IEEE, 2=Ethernet 

osiO 

16-31 - Reserved 
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Bit Assignments for Serial, Network, and Line Printer Devices 



bits 16-19 

20-23 

24-27 

28-31 

Cent 

If 

16-27 - Reserved 

Handshake mode: 
l=Automatic, 
using ACK, BUSY 
2=Automatic, 
using BUSY only 
3=Bidirectional 
read/write (for 
ScanJet) 4=Stream 
mode 5=Pulsed 
mode, using ACK, 
BUSY 6=Pulsed 
mode, using BUSY 
only 

IprO 

Iprl 

lpr2 

lpr3 

SCSI target 

SCSI LUN 

24 - Diagnostic 

access 

25 - Reserved 

26 - Auto form 
feed 

27 - Case fold 

28 - Raw mode 

29 - No wait 

30 - Old paper-out 
behavior 

31 - Eject page 
during paper-out 
recovery 
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Bit Assignments for Miscellaneous Devices 



bits 16-19 

20-23 

24-27 

28-31 

sctl 

SCSI target 

SCSI LUN 

Reserved 

0=Select with 

ATN enabled 
(default) 
l=Select with 

ATN controlled 
by 

scsi_cmd_par 

ms ^ 2=Inhibit 
inquiry at open 

>2 - Not 
supported 

instr 

0 

16-20 - Instrument address 

21-23 - Reserved 

24 - Diagnostic access 

25-31 - Reserved 

ptyO 

ptyl 

Bits 8-31 - Unique hex value for pty 


pdnO 

Bits 16-23=2 (type) 

24 - Diagnostic bit 

25-31 - unused 

psiO 

psil 

16-23 - Reserved 

24 - diagnostic 

25-31(psi0) - Reserved 

25-31(psil)-PDA Index 

graph 

3 

16-23 - Bus specifier 

Unused 

0=lmage planes 

l=Overlay 

planes 

ps2 

b 

(hexadecimal) 

b 

Reserved 

Port number 

28 - Autosearch 
0=Off, l=On. 

If 28 is On, 29 
used as follows: 

0=Mouse 

l=Keyboard 

30-31=0 
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Bit Assignments for Miscellaneous Devices 



bits 16-19 

20-23 

24-27 

28-31 

audio 

Instance 

Number 

0=Read/writ 

e device 

l=control 
only device 

Output 
destination 
(Ignored if 

bits 28-31=0.) 
0=Headphone, 
internal 
speaker, line 
out for Audio 

n 

l=Headphone 
only 2=Int. 
speaker only 
3=No output 
4=Line output 
only (Audio 

H) 

Output format 
(Ignored if 

bits 20-23=1) 

0=No change 
l=Mu-law 

2=A-law 

3= 16-bit linear 


a. See/usr/include/sys/scsi . h. 

b. Corresponds to bits 1011, for the function number of the PS2 device. 
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Associating a Custom Driver with a 
Peripheral 

If you are configuring H P peripherals and standard H P drivers, H P-UX 
configures the elements automatically, provided the drivers have been 
included in the kernel input file. 

Consider, however, the scenario of having a peripheral device for which 
you need to use a custom driver. Perhaps you have received the driver on 
a tape, which you have loaded onto your system. I f you want to associate 
a driver with only a specific hardware path, you must include the driver 
and the peripheral address in a "driver statement" of the /stand/system 
file. You must make sure the driver can be found by the kernel-build 
utility, and you must rebuild the kernel. 


NOTE You can use this technique to load any sio-style driver or wsio-style 

device driver. You cannot force-configurewsio-style interface drivers at a 
specific address using this technique. However, you can configure 
wsio-style interface drivers as long as the driver is included in the 
system fileand no other interface driver in the /stand/system file can 
claimthecard in question. For further information, refer to the Driver 
Development Guide 


Step 1. Rebuild the kernel to include the added device driver, by following these 
steps: 

a. Change directory to the build environment (/stand/build). There, 
execute a system preparation script, system_prep. system_prep 
writes a system file based on your current kernel in the current 
directory. (That is, it creates /stand/buiid/system.)The-v provides 
verbose explanation as the script executes. 

cd /stand/build 

/usr/lbin/sysadin/system_prep -v -s system 

b. Manually edit the /stand/buiid/systemfilein two pi aces to add the 
custom driver: 


NOTE Do not use the kmsystem command to perform this step; edit the file 
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directly. 


1. List the driver in the upper portion of the system file, with other 
similar drivers. For example, the following figure shows the upper 
portion of a system file with a custom SCSI driver, disco added. 

•k-k-k-k-k-k-k-k-k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k'k-k-k-k-k-k'k-k-k-k'k-k-k-k'k-k 

* Bus-Dependent subsystems 

* ccio = Cache Coherent I/O 
ccio 

***********Vr'*’Vr*Vr*Vr*Vr'*’Vr*Vr'*’Vr*Vr'*’Vr*Vr***Vr'*’Vr*Vr'*’Vr*Vr'*’Vr*Vr*Vr*Vr'*’Vr*Vr*Vr*Vr'*’Vr*Vr*Vr*Vr'^ 

* SCSI drivers 

disco 
sdisk 
sf lop 
stape 


2. Add a driver statement at the end of the file, if you intend to 
force-load the driver at only a certain hardware path. 

The driver statement tells H P-UX to associate the driver at a 
specified hardware address and has the following format: 

driver <hardware path> <driver_name> 

For example, a driver statement to associate a custom driver 
named disco with an interface card at address 2/0/7. 6.0 on a 
Model 755 resembles this: 

driver 2/0/7.6.0 disco 

Note, although an FI P-UX disk device driver (such as sdisk) may 
be present in the kernel, this driver statement instructs FI P-UX to 
use disco for the disk at address 2/0/7. 6 . 0 , only. FI P-UX 
continues to use its standard disk device drivers for any other 
disks. If disco should replace all instances of sdisk in the kernel, 
you could simply remove sdisk from the system file and replace it 
with disco. You only need to add a driver statement if you want to 
force-configure the driver to a specific path(s). 

c. Create a small file in the /usr/conf/master.d directory to be 

cross-referenced by the /stand/system file entry when the kernel is 
rebuilt. Thefilecan be given any name, but should have the following 
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format (which resembles that of the driver_install portion of 

/usr/conf/master. d/core-hpux): 

$DRIVER_INSTALL 
<driver_name> -1 -1 
$$$ 

For example, here is a file for the disco driver. 

$DRIVER_INSTALL 
disco -1 -1 
$$$ 

d. Verify that the driver you are installing has been built into a library 
that can be found by the mk_kernei utility. 

If you have been provided this driver from a third-party company, 
their engineers are likely to have compiled the driver into a library 
which you will have loaded into /usr/conf/iib when you loaded 
thei r tape onto your system. 

To examine an archive, run the ar command with the -t option, 
giving the library as an argument. Hopefully, you will see the file 
(such as disco.o, or whatever file name the driver is stored in) 
amongthe files included in the output from the command. 

/usr/ccs/bin/ar -t /usr/conf/lib/libdisco.a 

If you do not find the file, you will need to add the driver into a library 
in /usr/conf/iib. Do this with the -r option of the ar command. For 
example, to add disco.oto /usr/conf/iib/iibhp-ux.a, execute the 
following: 

/usr/ccs/bin/ar -r /usr/conf/lib/libhp-ux.a disco.o 

Once you have verified that the .o file is present in a library 
accessible to mk_kernei, you are ready to build your kernel to include 
the new driver. 

e. Makesureyou returned to the /stand/buiid directory. Buildthe 
kernel by invoking themk_kernei command. This action creates 
/stand/buiid/vmunix_test, a kernel ready for testing. 

/usr/sbin/mk_kernel -s system 

f. Verify that everything built correctly by executing the nm command 
and greping for the driver name. The command string should return 
at least one entry, such as that shown below. 

/usr/ccs/bin/nm vmunix_test | grep disco 
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disco_install | 524264|extern|entry |$CODE$ 

g. Save the old system file by moving it. Then move the new system file 
into place. 

mv /stand/system /stand/system.prev 
mv /stand/build/system /stand/system 

h. Prepare for rebooting by invoking the kmupdate command. This 
action sets a flag that tells the system to use the new kernel when it 
restarts. 

/usr/sbin/kmupdate 

Step 2. Notify users that the system must be rebooted. 

Step 3. Shut down and halt the system using the /usr/sbin/shutdown -h 
command. 

Step 4. Turn off power to the SPU. 

steps. Install the peripheral device. Make sure the peripheral's hardware 

address is set to the hardware path specified in the driver statement of 

the /stand/system file. 

Step 6. Power up the peripheral device and then the SPU. 

When the kernel reboots, you can verify that the custom driver was 
configured into the kernel by executing /usr/sbin/ioscan 
-f. You should seethe driver associated with its intended device at the 
hardware path you specified in step 2. 

For further information on driver statements and other custom!zations 
of the /stand/system file, consult the config (IM) manpage. The conf ig 
program is used by mk_kernei when you build a kernel. 

Under most circumstances, insf creates useful device special files when 
the system boots up. However, for some special circumstances, it may be 
necessary to create these files using mknod. 
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Creating Device Special Files using mknod 

To create device spaiial files for any driver other than those listed on the 
insf and mksf manpages, use mknod. 

Step 1. Change di rectory to /dev. 

Step 2. Determine the major number by invoking the isdev command. 

Step 3. Construct a minor number for the device by using the bit assignments for 
the device driver. For HP devices, the bit assignments are found in tables 
earlier in this Appendix. For custom device drivers, consult 
documentation supplied with the driver. 

Step 4. Create the device special files for the device using the following syntax: 

/usr/sbin/mknod <file_naine> b|c <major#> <minor#> 

• Name the file something easily associated with the device. 

• Use b for block device special file or c for character device special file. 

• Make files for both block and character if driver supports both. 

• Use the block or character major number reported by isdev. 

• Use the mi nor number constructed from the bit assignment tables. 

For example, the scope device driver has block and character major 
numbers of 65 and 234 respectively. Its minor number of 0 x 026000 is 
constructed like instrO (seeTableC-7, "Bit Assignments for 
M i seel I aneous Devices.") Bits 8 through 15 encode 2 as the card instance 
of the interface card and bits 16 through 19 encode 6 as the instrument 
address. 

/usr/sbin/mknod /dev/scope b 65 0x026000 
/usr/sbin/mknod /dev/c_scope c 234 0x026000 

steps. Verify the configuration by invoking ioscan with the -fun or fkn option. 
If created properly, the new device special files will be displayed with the 
configured device. 
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Worksheets 


Copy these worksheets as many times as you need for the devices on 
your system. 

Keep a current copy of /usr/sbin/ioscan -fk output as an aid in 
configuring and troubleshooting your system. 
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Interface Cards 


Table D-1 


Table D-2 


Interface Cards 


Part name and number; 


Version and date; 


Serial number; 


Firmware revision; 


Station address (LANIC ID) “ ; 


Hardware address; 


Dip switch settings; 



a. Use /usr/sbin/lanscan or/usr/sbin/lanadmin to identify 
the station address. 


Part name and number; 


Version and date; 


Serial number; 


Firmware revision; 


Station address (LANIC ID); 


Hardware address; 


Dip switch settings; 
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Terminals and Modems 


Terminals and Modems 

Table D-3 


Part name and number; 


Serial number: 


Cabling: 


Interface card, port number ^ : 


Hardware address: 


Dip switch settings ^ : 


Driver, device file, minor number: 


Modem use, baud rate, protocol: 



a. Note if configured via DTC or distribution panel. 

b. Note if configured as console or serial terminal. 


Table D-4 


Part name and number: 


Serial number: 


Cabling; 


Interface card, port number; 


Hardware address: 


Dip switch settings; 


Driver, device file, minor number: 


Modem use, baud rate, protocol: 
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Worksheets 

Disk Drives 


Disk Drives 

Table D-5 


Part name and number; 


Serial number: 


Firmware Revision: 


Number of disks, capacity: 


Interface card, port number; 


Hardware address: 


Dip switch settings: 


Drivers, device special files, minor 
numbers: 


LVM physical volume, volume group: 


RAID level, use ® : 



a. For example, file system, boot, dump, swap, raw data. 


Table D-6 


Part name and number; 


Serial number: 


Firmware Revision: 


Number of disks, capacity: 


Interface card, port number; 


Hardware address: 


Dip switch settings: 


Drivers, device special files, minor 
numbers: 
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Worksheets 

Disk Drives 


Table D-6 


Table D-7 


Table D-8 


LVM physical volume, volume group: 


RAID level, use: 



Part name and number: 


Serial number: 


Firmware Revision: 


Number of disks, capacity: 


Interface card, port number: 


Hardware address: 


Dip switch settings: 


Drivers, device special files, minor 
numbers: 


LVM physical volume, volume group: 


RAID level, use ^ : 



a. For example, file system, boot, dump, swap, raw data. 


Part name and number: 


Serial number: 


Firmware Revision: 


Number of disks, capacity: 


Interface card, port number: 


Hardware address: 


Dip switch settings: 
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Worksheets 

Disk Drives 


Table D-8 


Drivers, device special files, minor 
numbers; 


LVM physical volume, volume group: 


RAID level, use: 
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Tape Drives 


Tape Drives 

Table D-9 


Part name, number, type of tape drive; 


Serial number: 


Firmware Revision: 


Capacity; 


Interface card, port number; 


Hardware address: 


Cabling; 


Dip switch settings; 


Drivers, device special files, minor 
numbers; 


Use 



Table D-10 


Part name, number, type of tape drive; 


Serial number: 


Firmware Revision: 


Capacity; 


Interface card, port number; 


Hardware address: 


Cabling; 


Dip switch settings; 


Drivers, device special files, minor 
numbers: 
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Worksheets 

Tape Drives 


Table D-10 


Use 
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Printers and Plotters 

Table D-11 


Part name, number; 


Serial number: 


Firmware Revision: 


Capacity; 


Interface card, port number; 


Hardware address: 


Cabling; 


Dip switch settings; 


Drivers, device special files, minor 
numbers; 


Means of access: 



Table D-12 


Part name, number; 


Serial number: 


Firmware Revision: 


Capacity; 


Interface card, port number; 


Hardware address: 


Cabling; 


Dip switch settings; 


Drivers, device special files, minor 
numbers: 
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Worksheets 

Printers and Plotters 


Table D-12 


Means of access: 


266 


Appendix D 





Worksheets 

Uninterruptible Power Systems (UPS) 


Uninterruptible Power Systems (UPS) 

Table D-13 


Part name, number; 


Serial number: 


Firmware Revision: 


Rated load capability: 


Interface card, port number; 


Hardware address: 


Cabling; 


Dip switch settings; 


Drivers, device special files, minor 
numbers; 


Hardware coverage: 



Table D-14 


Part name, number; 


Serial number: 


Firmware Revision: 


Rated load capability: 


Interface card, port number; 


Hardware address: 


Cabling; 


Dip switch settings; 


Drivers, device special files, minor 
numbers: 
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Worksheets 

Uninterruptible Power Systems (UPS) 


Table D-14 


Hardware coverage; 
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Symbols 

/dev/cua#p#, 89 
/dev/cul#p#, 89 
/dev/mux#, 71 
/dev/tty#p#, 71, 73 
/dev/ttyd^^#, 89 
/etcychecklist, 119 
/etcyei sa/confi g. I og fi I e, 208 
/etc/exports, 125 
/etc/fstab, 119, 130 
/etcygettydefs, 99 
/etcyinittab, 97, 165 
/etcyicconfig, 26 
/etcyi p/i nterface, 182 
/etcyivmtab, 122, 124 
/etcysyslog.conf 
redirecting log messages, 195 
/etcyups_conf, 192 
/sbin/dasetup, 98 
/sbin/lib/eisa directory, 200 
/sbin/rc, 192 

/stand/build, 29, 62, 74, 111, 
117, 120, 122, 128, 144, 

153, 173, 179, 252 
/stand/build/system, 29, 62, 74, 
117, 120, 144, 153, 180, 252 
/stand/build/vmunix_test, 30, 

63, 75, 112, 118, 120, 123, 
128, 144, 153, 174, 180, 254 
/stand/ioconfig, 26 
/stand/system. 111, 172, 238 
driver statement, 252 
kernel configuration file, 255 
/stand/vmunix, 30, 111, 128, 255 
/usr/conf/lib, 238 
/usr/conf/lib^bhp-ux.a, 238, 254 
/usr/conf/master.d, 238, 239 
/usr/includ^sys/mtio.h, 244 
/usr/l bi n/sysadm/system_prep, 
174 

/usr/l bin/ups_mond, 192 
/usr/sbin/sam, 68, 69, 79, 111, 
143, 153, 192 


MSG_ONLY 

noncritical operation, 194 

Numerics 

28643A, 58 

28643A SCSI Fiber-Optical 
Extender, 56 

5061-2569 (serial connector), 
189 

5961-8383, 188 
700/60, 71 
700/96, 71 
700/98, 71 

7596A Draftmaster II plotter, 
179 


A 

A1439A CRX-24 graphics 
display interface card, 44 
A2269A Dual CRX graphics 
display interface card, 44 
A2941A, 191 
A2994A, 191 
A2996A, 191 
A2997A, 191 
A2998A, 191 
accelerator card 
HP A1454A, 44 
access mode bits, 245 
Access port M UX16, 80 
access to printers and plotters, 
162 

adding drivers, 153 
adding peripherals 
summary, 29 
addressing, 238 
by decreasing priority, 150 
device drivers, 238 
adjusting minor number bits to 
read other densities, 243 
adjusting minor-number bits, 
238 


anti-static workstation, 32 
APPCC-1250UX, 191 
APPCC-600UX, 191 
ar(l), 254 
ar(lM), 238 

asioO, 35, 71, 73, 166, 175, 245 
associating driver and 

peripheral manually, 255 
asynchronous data 
communication, 35 
ATT V.4 file-system layout, 114 
attached line printer bit, 245 
audio, 250 
AUl LAN,46 
AUTO file, 126 
auto form feed bit, 245 
autoload, 20 
autoch 

class in sampie ioscan output, 
145 

autoxO, 244 

B 

backplane slot priority, 33 
backward compati bi I i ty 
/etcychecklist, 119 
configuring disks with hard 
partitions, 116 
configuring LVM disks, 116 
configuring SDS disks, 115 
configuring whole disks, 115 
disktab(4), 121 
magneto-optical disks, 141 
s2, 121 

section numbers, 108 
Series 700 SDS disks, 114 
Series 700 whole disks, 114 
Series 800 hard partitions, 114 
baud rate for modem, 69 
baud switching, 92 
baud-rate mismatch, 99 
bdevsw, 238 
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Index 


bdf(l), 119 
Bell/CCITT, 245 
bit assignments, 244 
disk drivers, 244 
line printer devices, 245 
magneto-optical devices, 244 
miscelianeous devices, 250 
network devices, 245 
serial devices, 245 
tape drivers, 244 
block I/O, 238 
block major number, 239 
boot administration 
boot ROM menus, 129 
LVM maintenance mode, 129 
mode, 129 

booting in LVM maintenance 
mode, 129 
BREAK signal 
used for INTR and baud 
switching, 92 
BSD behavior bit, 244 
build environment, 29, 62, 74, 
111, 117, 120, 122, 128, 
144, 153, 173, 179, 252 
bus architecture 
multi-processing system, 231 
bus relationships 
Model 712, 222 
Model 725, 223 
Model 770(1 Series), 226 
Model E, 227 
Model T500, 231 
Models 8x9 (K Series), 234 
Models F/G/l/I, 8x7, 230 


C1006A/G/W, 71 
C1007A/G/W, 71 
C1017A/G/W, 71 
C1064A/G/GX/W/WX, 71 
C1065A/G/W, 71 


C1080A/G/W, 71 
C1083W, 71 
C1084W, 71 
C1085W, 71 
C2400-UTIL fileset 
for disk array tools, 104 
c700, 55, 108, 140 
c720, 55, 108 
cable length, SCSI, 58 
cables 

92222A/B/C/D, 56 
C2900A, 56 
C2901A, 56 
C2902A, 56 
C2903A, 56 
C2906A, 56 
C2907A, 56 
C2908A, 56 
C2911A, 56 

for Switchover configurations, 
58 

K2296, 56 
K2297, 56 
cabling guidelines 
RS-232-C devices, 40 
SCSI, 56, 57 

capacities, magneto-optical disk, 
139 
capacity 

magneto-optical disk libraries, 
138 

card i nstance, 241 
and class, 21 
and interface card, 21 
correlating device files, 27 
defined, 21 

cartridge tape bit, 244 
case fold bit, 245 
CCITT, 245 

CCITT protocol for modem, 69 
control signals, 92 
cdevsw, 238 
CD-ROM configuration 


planning, 105 
cent(7), 177 

Centif, 42, 169, 177, 245 
handshake modes, 177 
centronics configuration 
requirements 
for plotters, 169 
for pri nters, 169 
centronics interface, 42 
CFG files, 200 

checking for correctness, 212 
format, 200 

changing choices for E/ISA board 
functions, 206 
character I/O, 238 
character major number, 239 
CharDrv, 169 
ChrDrv, 42 
CIO 

SCSI tape drives, 150 
Series 800 magneto-optical 
disk drives, 140 
Series 800 RS-232-C plotters, 
166 

Series 800 RS-232-C printers, 
166 

Series 800 SCSI disk drives, 
108 

Series 800 SCSI printers, 171 
Series 800 SCSI tape drivers, 
150 

cio_ca0, 35, 46, 55, 71,108,140, 
166, 171 
class 

and instance number, 26 
of interface, 21, 26, 241 
command 
cat, 97 

comment, eisa_config, 205 
init, 95, 205 
lifcp(lM), 127 
mkboot(lM), 127 
move, 209 
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remove, eisa_config, 210 
save, eisa_ccinfig, 208 
set (shell command), 100 
stty, 99 
who, 95 

comment command, elsa_config, 
205 

compatibility pseudo-driver 
(cpd), 114 

compression, data, 150, 157 
config(lM), 255 
configuration 
initializing, 205 
configuration guidelines 
graphics devices, 44 
SCSI, 55 
console 

compared to terminal 
configuration, 78 
configuri ng a non-H P termi nal, 
79 

connectivity for, 35 
HP 700/60 configured in 
non-H P modes, 79 
planning to configure, 68 
VT 100-compatible, 79 
VT320, 79 
Wyse 60, 79 
console, remote, 35 
consoles, 78 
core, 55 
core-hpux, 239 

correcting an error while using 
eisa_config, 205 
correlating components and 
device special files, 24 
cpd, 114 

creating an LVM mapfile, 122 
creating new sci files, 208 
cron(lM), 195 
crontab file and UPS, 195 
CS80 

unit bits, 244 


CTS/RTS (hardware flow 
control) for modems, 92 
cue(l), 86 
cuegetty(lM), 86 
custom device drivers, 252 
custom drivers, 31 
customized graphics 

configurations, maintaining 
accuracy of, 46 

D 

daemons 
syslogd, 195 
system logging, 192 
U PS monitoring, 192 
ups_mond, 195 

data bits, terminal vs console, 78 
data communication and 

terminal controllers (DTC), 
39 

16TN/MX, 39 
72MX, 39 

J 2060A/J 2063A, 39 
J 2070A, 39 
data compression 
avoiding its use on tape drives, 
157 

dealing with, 150, 157 
DEC terminals, 69 
DEC VT terminals, 80, 83 
emulation limitations, 87 
decimal, binary, and 

hexadecimal equivalents, 
241 

DELT-2326/C2, 191 
DELT-2336/C2, 191 
determining aval I able addresses 
using ioscan, 24 
dev_t format, 240 
device adapter 
installing, 31 
device configuration 


using SAM, 16 
device drivers, 238 
addressing, 238 
and disk drives, 107 
and magneto-optical devices, 
138 

and major numbers, 238 
associating custom driver with 
a peripheral, 252 
bit assignments, 244 
dev_t format, 240 
for parallel (centronics) 
plotters, 169 
for parallel (centronics) 
printers, 169 

for printers and plotters, 165 
for SCSI disk, 108 
for SCSI printers, 171 
for SCSI tape drives, 150 
for serial (RS-232-C) plotters, 
166 

for serial (RS-232-C) printers, 
166 

for terminals and modems, 71 
kernel association, 238 
location, 238 
major number, 239 
device installation 
requirements, 15 
device number 
defined, 21 
device special files 
and hardware path, 27 
associated with a peripheral 
device, 28 

bit assignments, 240 
correlating with hardware 
components, 24 
creating customized for tape 
drives, 156 

creati ng for modems, 89 
creating for serial printer or 
plotter, 175 
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creation, 114 
disk drives, 108 
exhaustive mode for tape 
drives, 156 

floppy disk drives, 109 
for printers and plotters, 175 
for tape drives, 154 
magneto-optical disk drives, 
140 

major and minor numbers, 238 
plotters, 166, 169 
printers, 166, 169, 171 
tape drives, 150 
diagnostic bit, 244, 245 
disci, 244 
disc2, 244 

discs, 108, 109, 140, 244 

disc4, 244 

disk 

class in sample ioscan output, 
145 

disk array configuration 
planning, 104 
RAID levels, 104 
disk drives 
7957B, 108 
7958B, 108 
7959B, 108 
A1999A, 108 
A2655A, 108 
A2657A, 108 
A3058A, 108 
A3182A, 108 
A3231A, 104, 108 
A3232A, 104, 108 
and device drivers, 107 
C2212A, 108 
C2213A, 108 
C2214B, 108 
C2216T, 108 
C2217T, 108 
C2281A, 108 
C2282A, 108 


C2290A, 108 
C2291A, 108 
C2293A/T/U, 108 
C2295B, 108 
C2425J K, 108 
C2427J K, 108 
C2460F/R, 108 
C2461F/R, 108 
C2462F/R, 108 
C2470S, 108 
C2471S, 108 
C2472F/R/S, 108 
C2473F/R/S, 108 
C2473T, 108 
C2474F/R/S, 108 
C2474J , 108 
C2476F/R, 108 
C2481A, 108 
C2482A, 108 
C2491A, 108 
C2492A, 108 
C3020T, 108 
C3021T, 108 
C3022R7r, 108 
C3023R/RZ/T, 108 
C3023T, 108 
C3024R/RZ/T, 108 
C3024T, 108 
C3027U, 108 
C3028U, 108 
C3032T, 108 
C3033T, 108 
C3034T, 108 
C3035T, 108 
C3036T, 108 
C3037U, 108 
C3038U, 108 
C3040R/T, 108 
C3041R/r, 108 
C3044U, 108 
C3560U, 108 

device special files created, 108 


moving using FIP-UX 
commands, 125 
planning to configure, 104 
disk model number 
finding out, 135 
diskinfo(lM), 112, 135, 139 
disks drives 
further tasks, 136 
disktab(4), 105, 121 
distribution panels 
0950-2431, 38 
28659-60005, 38 
5062-3054, 38 
5062-3070, 38 
5062-3085, 38 
5181-2085, 38 
ADR 5062-3070, 35 
ADP422 5062-3085, 35 
characterized, 38 
DDP 5062-3066, 35 
DDP 5181-2085, 35 
MDP 5062-3054, 35 
purpose of, 37 
RJ 45 0950-2431, 35 
serial connectivity, 37 
DLKM (Dynamically Loadable 
Kernel Module) feature, 19 
DLKM modules 
advantages of, 20 
driver behavior, controlling, 238 
Driver Development Guide 
Series 700 resource, 107 
driver install table, 239 
driver library, location of, 254 
driver statement, 252 
DTC Manager software, 39 
DTCs 

purpose of, 37 
serial connectivity, 37 
dump 

managing when moving a root 
LVM disk, 125 
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managi ng when removi ng a 
disk, 133 

dynamically assigned major 
numbers, 239 


E/ISA boards 

changing choices for board 
functions, 206 
choices, 201 
moving, 209 
removing, 210 
resources, 200 

setting switches and jumpers, 
209 

troubleshooting configuration, 
212 

eeprom, 55 
EISA 

boards, 200 
defined, 42 
SCSI disk drives, 108 
SCSI tape drives, 150 
eisa, 55, 108 
EISA device 
swappi ng to, 42 
eisa_ccinfig 

changing choices for board 
functions, 206 
correcting an error, 205 
example session, 203 
exiting, 208 

initializing configuration, 205 
interactive mode, 203 
log file, 208 
movi ng boards, 209 
removing boards, 210 
saving configuration, 208 
troubleshooting, 212 
eisa_ccinfig(lM), 172 
Ethernet bit, 245 
EtherTwist, 46 


examples 

/etcysyslog.conf entry for 
redirecting UPS log 
messages, 195 

/usr/conf/master.d sample file 
entry, 254 

calculating SCSI cable length, 
58 

check! ng syntax of EISA C F G 
file, 212 

configuration of a UPS, 188 
configuring U PS tocyclepower 
during non-work hours, 
195 

correlating card instance and 
device files, 27 

creating device special files for 
modem, 90 

determining available 

addresses using ioscan, 24 
diskinfo output for disks, 135 
diskinfo output for 

magneto-optical disk, 139 
displaying EISA board 
information, 205 
editing /etcyuucp/Devices for 
modem, 92 

entries in /etc/ttytype, 78 
force configuration of device 
drivers, 252 

getty entry for a U PS port, 193 
getty entry i n /etc/i nittab for 
modem, 91 

identifying device special files 
with a tape device, 28 
interacting with thelSL, 129 
ioscan -fn output showing tape 
device special files, 28 
ioscan output for a Model 725, 
224 

ioscan output for a Series 800 
multi pi uxer card, 192 


ioscan output for H P-l B 
instrument, 181 
ioscan output for 

magneto-optical disk 
library, 145 
ioscan output for mux 
interface, 176 

ioscan output for serial printer, 

176 

ioscan output of a LAN card, 64 
ioscan output of a Model 8x9 (K 
Series), 234 
ioscan output of a 

multi-function card, 229 
i oscan output of a T500 system, 
234 

ioscan output of tape driver, 
154 

Issf output for serial printer, 

177 

I ssf output for serial printer 
with hardwareflow control 
(RTS/CTS) enabled, 177 
Ivinboot output, 125 
minor number for printer, 176 
mksf command for read! ng 
non-default tape format, 
156 

mksf command for tape driver 
exhaustive mode, 157 
mksf command to prevent tape 
data compression, 157 
moving a disk, 125 
moving a printer or plotter, 

182 

output from I ssf for modem 
files, 90 

output of ps -ef, 97 
portion of/stand/system file, 
253 

sample CFG file used by 
eisa_config, 200 
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sampledisplay of EISA CFG 
files, 204 

sampie display of eisa_config 
switch/jumper settings, 

207 

sample eisa_config exit, 

showi ng subsequent steps, 
206 

sample eisa_config start-up 
screen, 203 

setting hardware flow control 
(RTS/CTS) for serial 
printer, 176 

tar test to verify tape driver 
configuration, 155 
using eisa_config show slot 
command, 204 
using ioscan -C (class) option, 
28 

exhaustive mode for tape-device 
special files, 156 
exports(4), 125, 132 
ext_bus and instance number, 

26 

extracting the system file, 29, 
62, 74, 111, 117, 120, 122, 
128, 144, 153, 173, 179, 252 

F 

fddi, 47 

fiber-optic extender cable for 
SCSI, 58 

field separators, 25 
fifo bits, 245 
file 

/etc/eisa/config.log, 208 
CFG, 200 
file type, 238 
fileset for disk array 
configuration, 104 
file-system layout, 114 
floppy disk drives 


adjusting minor number bits, 
243 

configuration guidelines, 109 
configuration planning, 105 
device special files created, 109 
floppy disks and FI P-UX 
capability for mounted file 
system, 105 

differences from PC floppies, 
105 

intended use and limitations, 
105 

floppy(7), 105 
force configuration, 252 
force configuration of device 
drivers, 252 
formats 

handling differences on tape 
media, 156 
framebuf, 43 
fstab(4), 119, 130 
full ioscan listing, 27 
further tasks 
disk drives, 136 
magneto-optical devices, 147 
tape drives, 158 
fuser(lM), 95 

G 

garbage data 
on terminals, 95, 98 
geometry determined, 244 
getty, 165 
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